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The equipment described in this manual generates and uses radio-frequency 
energy. If it is not installed and used properly, that is, in strict accordance with 
our instructions, it may cause interference with radio and television recepMon. 
This equipment has been tested and complJe$ wilh the liruits for a Class B 
computing <Jevice In accordance with the specincations in Subpart J, Part IS 
of FCC rules. These rules are designed to provide reasonable protection 
against such interference in a residential instaJlation. However, there is no 
guarantee that the Interference will not occur in a particular installation 
especially if you use a "rabbit ear" television a/itenna. (A Tabbit ear" antenna 
is the telesooping^rod type usually contained on TV receivers.) 

You can determine whether your computer is causing interlerence by turning It 
off. If the interference stops, it was probably caused by the computer or its 
peripheral devices. To further isolate the problem: 

■ Disconnect the peripheraf devices and their input/output cables one at a 
time, it the interference stops, it is caused by either the peripheral device 
or its im cable. These devices usualiy require shielded I/O cables. For 
Appie peripheral devices, you can obtain the proper shielded cable from 
your dealer. For non-Apple peripheral devices, contact the manufacturer 
or dealer for assistance. 

\i your computer does cause interference to radio or television reception you 
can try to correct the interference by using one or more of the foHowino 
measures: 

• Turn the TV or radio antenna until the interference stops. 

• r^ove the computer to one side or the other of the TV or radio. 

• Move the computer farther away from the TV or radio, 

■ Plug the computer into an outlet that is on a different circuit than the TV or 
radio. (That Is, make certain the computer and the radio or television set 
are on circuits controlled by different circuit breakers or (uses.) 

• Consider installing a rooftop television antenna wfth coajf iaJ cabJe Jead-in 
between the antenna and TV. 

If necessary, you should consult your dealer or an experienced radio/television 
technician tor additional suggestions. You may find helpful the following 
booi^let. prepared by the Federal Communications Commission: 
•How to (dent/fy andHesoive Radio^TV interference Probiems. " 
This booklet is available from the U.S. Government Printing Office 
Washington, DC 20402, stock number 004-0OO-00345-4. 
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This is the reference manual for the Apple lie personal 
computer. It contains detailed descriptions of ali of the 
hardware and firmware that make up the Appie lie. The manual 
is divided into two volumes: Volume I contains all the chapters; 
Volume II contains the appendixes. 

This manual contains a lot of information about the way the 
Apple lie works, but it doesn't tell you how to use the Apple lie. 
For this, you should read the other Apple lie manuals, especially 
the Appie tic Interactive Owner's ManuaL 

This manual describes the internal operation of the Apple He as 
completeiy as possible in a single reference work. The criterion 
for deciding to include an item of information was whether it 
would help an assembly-language programmer or hardware 
designer. 



Contents of This Manual 



This manual presents first the physical characteristics of the 
Apple lie (Chapter 1). then the hardware locations and firmware 
that control memory management and input/output (Chapters 2 
through 10). and finally the electrical and electronic 
inplementation of those capabilities {Chapter 11). The 
appendixes contain summary tables and information comparing 
other Apple products to the Apple lie. 

Chapter 1 identifies the main physical features of the Apple ilc. 

Chapter 2 presents an overview of the 65C02 microprocessor 
(whose instruction set appears In Appendix A), and then 
discusses the processor s address space, what it contains, and 
how to control it. 



Contents of This fvianual Ixxv 



Chapter 3 is an introduction to Ct>apters 4 through 9. It 
describes the common cliaracteristics of input/output 
processing. Chapters 4 through 9 tiien dtscuss the kinds of 
devices— both built-in and attachable—that the Apple lie 

supports: 

• Keyboard and speaker (Chapter 4) 

• Video display (Chapter 5) 

• Disk drives (Chapter 6) 

• Serial port 1 for printers and plotters (Chapter 7) 

• Serial port 2 for modems and other communication devices 
(Chapter 6) 

• Mouse and hand controls, including game paddles and 
joysticks (Chapter 9) 

Chapter 10 is a brief tutorial orv how to use the Monitor 
firmware to disassemble and debug machine-language 
programs, and manipulate memory contents. 

Chapter 11 is a detailed description of the hardware that 
implements the features described in the earlier chapters. This 
information is included primarily for programmers, but it will 
also help you if you just want to understand more about the 
way the Apple lie wuorks. 

Additional reference information appears in the appendixes. 
Appendix A is the manufacturer's descriptfon of the 65C02 
instruction set, including the 27 new instructions available on 
the CMOS version of the 65C02 used in the Apple lie. 

Appendix B is a memory map of the Apple lie, including detailed 
tables of page zero, page three, the screen holes, and the 
hardware page. 

Appendix C lists the pubHshed firmware entry points, arranged 
by address, and indicates where in the manual they are 
described. The Ifst includes I/O firmware (pages SCI through 
$CF) and Monitor firmware (pages $F0 through $FF). For 
Applesoft interpreter firmware (pages $D0 through $EF). refer to 
the Applesoft BASfC Reference Manual (in two volumes). 

Appendix discusses the operating systems and languages 
that run on the Apple lie. 

Appendix E describes how to use the Apple Jlc s interrupt 
handling capabilities. 
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Appendix F contains an overview of the differences among the 
Apple II series computers. 

Appendix G contains the keyboard layouts, code conversion 
tables, and external power supply characteristics of USA and 
International models of the Apple lie. 

Appendix H contains reference tables for code and number 
base conversion. 

Appendix I contams a listing code for the Monitor, enhanced 
video firmware, and input/output firmware contained in the 
Appie lie. The iistings do not include the buitt-in Appiesoft 
interpreter, which is discussed in the Applesoft BASIC 
Programmer's Reference Mar^uai 

The bibliography lists articles and books containing additionaJ 
information about the Apple lie and related products- 

The glossary defines many of the technical terms used in thte 

manual. 

At the back of this manuaf is a Tei! Apple Card. Please fill it out 
and send it in. Your experience with this manual will help us 
plan new reference materials. 



Symbols in This Manual 



Thfs manual uses a three-level numbering system to make iX 
easier to cross reference information. A reference like 2.4.3 
means Chapter 2, section 4, subsection 3, 8.1,8 refers to 
Appendix G. section 1, subsection 8. 

Special text in this manual is set off in several different ways, 
as shown in these examples. 



Warning 

Important m formation regaraing your safety or protection of 

data appears in boxes like this. 



Note: Information that is useful but not central to the 
discussion in a given part of the text appears in gray boxes 
like thfs. 



CaptiGng. cross-reJ&rerces and 

incidental definitions appear lo 
marginaf glosses like this. 
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This chapter introduces you to the Apple 11c. \t identifies the 
major components of the machine, both outside and inside, and 
tells you where in the rest of the manual to find information 
about each one. 



1, 1 Outside of Machine 



Appendix G Illustrates Bnd 
discusses several International 
keyboard layouts. 



Figure 1-1 shows an Apple lie with a Standard USA keyboard. 
This chapter discusses both the Standard (Sholes) and 
Simplified (Dvorak) USA keyboards, as well as the lights and 
switches on the front of the machine. 

Figure 1-2 is a diagram of the parts of the computer that you 
can see, hear, or access from the outside. The Apple He comes 
equipped wjth keyboard, speaker (with headphone jack and 
volume control), disk drive, attachable power supply, and 
internal voltage converter. It aiso has bui[t-sn interfaces and 
connectors for a seriai printer, video dispiay, special video 
display adapters, modem, mouse, and game controls. 



1.1 Outside of Machine 



rr 



There are no user connections Inside the Appie lie. but 
expansion is possible and easy with the connectors on the 
Apple lie back pand. 



Figure 1-1. Apple lie With 
Standard USA Keyboard 



Figure 1-2. Biock Oisgram at 
Exrerns) Features 




Keyboard Disk Drive Back Panel Speaker 

(See Figs. 1-4 and 1-5) (See Fig. 1-7) (SeeFlfl. 1*fi| (S&e Fig. 1-6) 



ASCri stands for American 
Standard Code for Information 
Intercnange. Table 4-2 lists the 
ASClil cliaracter encoding for (he 
Standard and Simplitied \JSA 
kevboards. AppendlK e hsts the 
encoding for imernatlonal 
keyboards. 



1,1,1 The Keyboard 

The front of the Apple He incfudes the keyboard (Figure 1-3). 
the computers pnmary input device. It has a typewriter layout 
uppercase and lowercase, and cari generate all 126 
characters — including control characters— in the ASCII 
character set. The front of the computer also has a reset key, 
80/40 switch, keyboard switch, disk-use light, and power light. 
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Figure 1-3. Keyboard and Front of Apple lie 




Reset Switch Keyboard Switch 

80/40 Column Switch Keyboard 



Power Light 



Disk Use Light 



Table 1-1 lists the characteristics of all Apple lie keyboards and 

front panels. 



Table 1-1. Keyboard Specffications 

Number of keys: 

Character encoding: 

Number qf codes: 

Features: 

Special tunclion keys: 

Cursor movement keys: 

Modifier kgys: 
Front-panel switches: 
Front-panel lights: 



63 

ASCK 

128 

Automatic repeat, Two-key rollover 



©- Q- & ©■ LBE™aH> raa-Ffn . 



rCtWTHQL") , fSHIFTl rCAPSJLOCKl . fiSCj l 

80/40 gwitcli, keyboard switch 
Power light, disk-use Kght 



Features 

The Apple lie keyboard has automatic repeat on all character 
keys: if you liold the key down longer than about a second, the 
character it generates repeats. It also has two-key roliover, 
which means if you type a second key before releasing a prior 
key, the new character enters the computer the same as 
though the previous key were released first. {This is important 
for fast touch typists.) 



1.1 Outside of Machine 
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The Apple keys are cornecled to 
one-bit addresses in memory, 

described in Chapter 9. 



Chapter 2 descriJses me results of 
the various reset procedures. 



The Monitor is a built-in program 
tlisl performs some of the basic 
actrvrties of the computer, such as 
retrieving and storing key codes as 
they come in, and clearing or 
updating the disptay screen. 



The othe r keys to use with 
[CQNTB&Li are: @ | \ | " _ and Iheif 
international equrvaleris (see 
Appendix G]. 
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Special Function Keys 

The Apple lie has three special function keys: Lreset") , and two 
keys marked with apples: one outlined, [d], and one filled in 



Creset] has a d irect line to the 65C02 microprocessor: holding 
down (CONTROL^ whife pressing (reseT) causes the Apple lie to 
restart processing with a program that puts the machine in a 
knoijvn state (Chapter 2). So you dont accidentally destroy 
current w ork, the reset takes effect only if you hold down 
LpoMTf^OL] while pressing [reset I 

If you hold down both [control] and O while pressing (resets 
the computer starts up as if you fust turned it on 



Cursor Movement Keys 

Four of the cursor movement keys have arrows on them: left, 
right, down and up. The other three keys are (return I Cpelete) 
and [^W). All generate ASCIJ control characters (Table 4-2). 
However, it is up to the operating system or application 
program to interpret and act on the control codes that these 
keys generate. 



Modifier Keys 

Three special keys, (control] , (^shIfTI and CbAPS-LOCiQ . change 
the codes generated by the other keys. None of these keys 
generates a code when pressed by itself. A fourth key. C^c) , 
generates a control code that the Monitor responds to by 
interpreting certain subsequent keystrokes in a modified way. 

{coNfnoO, when pressed in combination with letter keys or 
certain other keys, produces ASCII control characters. 

(SHIFT) works the same on the Apple He as on an ordinary 
typewriter: it selects uppercase letters and the upper characters 
on the keys. 



(caps-lockI . in its down position, changes the letter keys to 
uppercase, but does not affect other keys. 

is not a modifier key in the same sense as 



LcoNTRoQ and 

tSHiFT) ; you do not hold it down while pressing other keys. 
Rather, you press [Tsc) and it generates the ESC control 
character (key code $1B^see Table 4-2). Many programs, 
Including the built-in f^onilor program, then interpret other 
specific keys as designating an escape sequence. 
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Ttiis switch takes effect only if the 
program or aperating system you 
are using actually checks it- See 
Table 4-1. 



The 80/40 Switch 

The 80/40 switch selects whether information is to be displayed 
in 40 columns to the line or BO columns. This switch indicates 
40-colurrin display in its down position, and BO-column display 
in its up position. 

Note: Not all programs check this switch. Even programs that 
do check the switch may rely on the user setting it before 
running the program. 

The Keyboard Switch 

The keyboard switch selects which of the two keyboard layouts 
and character sets the computer is to get from the keyboard 
and display on the screen. On USA versions of the Apple He. 
select the Standard Sholes keyboard layout (Figure 1-4) with 
the switch in the up position, and the Dvorak Simplified layout 
(Figure 1-5) with the switch in the down position. 



Figure t-4. The USA Standard or Sholes Keyboard (Keyboard Switch Up) 
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1.1 Outside of Machine 



Figure 1-S. Simphfi&i of Dvorak Keyboard {Keyboard Swtch Down}. Note: Shaded cfiar^Gters may be fn different 
positfons on some modeis. 
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Appendix G illustrates the 
keyboard layouts for botti 
keyboard switch positions on 
several international versions □! the 
Apple lie, 



On international models, the keycaps indicate the character 
positions for the local keyboard layout, which is selected when 
the keyboard switch is down. When up. the keyboard switch 
selects the USA Standard characters and key layout. 



Disk-Use and Power Lights 

The red disk-use light glows whenever the bulft-in disk drive's 
motor is on. 

The green power light glows when normal power is present at 
the Apple ilc's internal power supply. 



Warning 

// the power fight flashes on and off, turn off the computer 
immediately. Find out what caused the condition (such as a 
brownout) and remedy it before turning the computer on again. 
Above aff, do not use the disk drive when the power fight is 
fiasf}ing; this may damage the computer. 
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The way programs control the 

speaker is described in section 4.2, 



1.i.2 The Speaker 

The Apple lie has a loudspeaker in the bottom of the case, as 
shown in Figure 1-6. The speaker enables Apple He programs 
to produce a variety of sounds that make programs more 
useful and interesting. There is also a volume control on the 
left side of the Apple lie case, and a mini-phone jack for 
connecting headphones or an external speaker. 

The jack accepts either one-channel (monaural) or two-channel 
(stereo) plugs, although speaker output is monaural only. 
Inserting a plug disconnects the built-in speaker. 

Figure 1-5. Speaker, Vofume Control and Phone Jack 




Phon$ Jack 
Voluriie Control Knob 



Speaker (Inside) 



1.1 Outside of Machine 
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I^D means input (Information 
coming into the computer) and 
output [information going out of the 
computer). i:;hapter 6 describes 
how to use t^e Apple lie's disk I/O 
harOware and firmware. 



1. 1.3 The BuilHn Disk Drive 

The Apple \\c has a built-in disk drive (Figure 1-7) that is fuliy 
compatible with Apple Disk II— that is, it reads and writes 
single-ssded, 35'track disks. The drive door is on tiie right side 
of the Apple He case. 

figure 1-7. BuiH-in Disk Drive 
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Disk Drive Door 



1, 1.4 The Back Panel 

The back panei of the Apple lie (Figure 1-B) has seven 
connectors and a main power switch. From left to right they 
are: 

• a 9-pin D-type miniature connector for connecting hand 
controls, a mouse, a joystick or some other pointing device 

• a 5"pin DIN connector for serial input and output (port 2; 
normally for a modem) 

• a 15-pin D-type connector for video expansion 

• an RCA-type jack for a video monitor 



^ 





• a iS-pin D-type connector for connecting a second disk 
drive 

• another 5-pin DIN connector for serial input and output 
(port 1 ; normally for a printer or plotter) 
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« a special 7-pin DIN connector for power input 
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The installation manuals for the external devices contain 
instructions for connecting them. Be sure to move the handle 
until it clicks into position for propping up the computer before 
attaching cables to the back panef. 



Figure 1-6. Back Psnet Connectors 
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Mouse artd Hand 

Control Connector Connector Connector 

[See Figs. 1 1-37 (See Fig, 1 1-30) ;See Fig. 1 1-25) 
and 11-42) 

Video Output 

Connector 

(SeeFjg. n-24> 



External 

Disk Drive 

Connector 

(See Fig. 11^26) 



External Power 

Connector 
ISeeFig. 11-1) 



1.1 Outside of Machine 
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1.2 Inside of Machine 



Chapter 11 discusses in further 
detail these components and how 
tliey work. 



Figure 1-9 shows the main components inside tl^e 

Apple lie computer* 

Figure 1-9. Biook Disgram of tnsiOe of MachSfis 
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Voltage 
Converter 



Speaker 

{underneath) 



BuSit-Jh 
DJ 5k Drive 



Main Logic Boafd 
(See Figure T-11) 
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1,2, 1 The tnternaf Voltage Converter 

The built-in voltage converter operates from a 15V DC source, 
such as provided by the external power supply furnished with 
the Apple lie (Figure 1-10). The voltage converter provides 
power for the logJc board, built-in disk drive, one external djsk 
drive, and the I/O signals available at the back paneL 
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Figure 1-fO. Poiver Supply and Voitags Convener 




Complete specilications of th* 
Apple lie power supply and voltage 
corverter appear in Chapter 11. 



Power Switch power Supply 

Internal Voltage Converter 

The voltage converter produces three different voltages: +5V, 
+ 12V, and -12V, (Minus 5V is derived from -12V on the main 
logic board.) It is a high-efticiency switching converter that 
protects itself and the rest of the Apple lie against short 
circuits and other mishaps. 



1.2.2 The Main Logic Board 

Almost all the electronic parts of the Apple lie are attached to 
the main logic board, which is mounted flat in the bottom of the 
case. 



1.2 Inside of Machine 
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Ftrmware is program code that is 
stored in read-only memory. It can 
be read and e»(ecuted, but not 
cfiariged. 



Character 

Generator ROM 

iWM 



TMG 



QLU 



AuxFiJary RAM 



MafnRAM 



Figure 1-11 shows the main logic board and the most importani 
integrated circuits (ICs) in the Apple lie. They are the 
CPU (central processing unit), RAM (random access memory), 
ROM (read-only memory) ICs for keyboard encoding, display 
character generation, and firmware, and the five custom 
integrated circuits. 

figure U11, Mam Logic Board 
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^ V-.-.^^-^i/'^ -j>4 Keyboard ROM 



;) 



Firmware ROW 



lOU 
MMU 

65C0S Microprocessor 



The specificaliors of me 65C02 are 
given in Chapter 11; the 65C02 
instruction set ps gjver In 
Appendix A_ 



The CPU is a 65C02 microprocessor. The 65C02 is a CMOS 
version of the 6502, which is an eight-bit microprocessor with a 
sixteen-bit address bus. In the Apple He, the 65C02 runs at 
1 MHz and performs up to 500,000 eight-bit operations per 

second. 
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Chapter 11 describes how RAM 
works; Appendix 3 lists important 
RAM locations. 



ROMs: see Chapter 11. 



The Applesoft largjgge iirterpreter 
is descritjecl in the Applesoft 
Tutorial and the Applesoft BASIC 
Programmer's Beference ManuBi. 



Memory addressing: see 
Chapter 3. 

See Chapters 3 through 9. 



Chapter 11 discusses the functEons 
of these integrated circuits in some 
derail. 



The keyboard is scanned by an IC that generates matrix values 
for a read-only memory (ROM), The vaJue of this ASCII code is 
latched and readable by programs. 

The character generator ROM converts display information to a 
form that display devices can use. 

The other ROM contains the Monitor the Applesoft BASIC 
interpreter enhanced video firmware^ and other input/oulput 
firmware. The firmware thai this ROM contains is described 
throughout this manual. 

Five of the large IC's are custonn-made for the Apple lie: 

• The Memory Management Unit (MMU) contains most of the 
logic that controls memory addressing in the Apple lie. 

• The Input/Output Unit (lOU) contains most of the logic that 
controls the built-in input and output features of the 
Apple He. 

• The Timing Generator (TMG) generates all the system and 
I/O clock and timing signals from a 14 MHz oscillator, 

• The General Logic Unit (GLU) performs the remaining logic 
functions required. 

• The Integrated Woz Machine (IWM) is a slnglechip version 
of the Apple Disk ll controiler card. 



1.2,3 The Other Circuit Boards 

The Apple lie contains other circuit boards that serve special 
purposes: a motor-speed control board and a read/write logic 
board for the disk drive, and a matrix board for detecting the 
position of keys pressed. This manual does not discuss these 
circuit boards. 



Warning 

Adjustment of disk drive speed must fte done by sn authorized 
Apple Service Center. Do not attempt to adjust the speed of 
your buiit'in disk drive. If you do. you may damage it and you 
win void your warranty. 
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This chapter js an introduclion to the microprocessor, the " 
number of separate locations (addresses) it can access, and the 
addresses set aside for special purposes. The last section of 
this chapter describes the reset routines, which restore the 
computer to a known state. 



Z 1 The 65C02 Microprocessor 



Figure 2-1 is a model of the 65C02 microprocessor. The 65CD2 
has one 16 bit register and five 8-bit registers. Registers are 
fast-acting storage areas where the processor performs and 
keeps track of its work. 



2.1 The 65C02 Microprocessor 
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Figure 2- 1 Block Disgrsm Modei of 6SC02. Copyright W82. NCR Corporation. 

Used by permission ot NCR Corporation, Dayton. Ohio. 
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Each of the otiner registers holds 
eight bits (one byte), so the 65CQ2 
is called an S-Wt processor. 



The I6'btt register Is called the program counter (PC) It 
specifies the address in memory that contains the instruction 
the processor is currently carrying out. A sixteen-bit register 
can specify any one of 65,536 memory addresses, and so the 
65C02 is said to have an address space ot 65,536 locations. 
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Appendix A lists the [nslrjctions 
the B5C02 can carry out, their use. 
and their effects on the registers. 
For further informatEOn. consult the 
pertinent books listed i.n the 
Gibliography. 



The five S-bit registers in the 65C02 are 

• The accumulator or A register. The accumulator is like a 
desktop where the processor performs mathematical and 
logical operations on Intormation. 

• The index registers, X and Y. The processor uses these 
registers to modify the address where intormation is to be 
found or placed, and to pass information from one program 
to another. 

• A stack pointer, or S register. The processor uses a 
256-byte region of memory — page 1 — as an area to stack up 
bytes for future use. The stack is empty when the computer 
is turned on. Several 65C02 instructions either push (store) 
the contents of a register onto the stack, or pij// (retrieve) a 
byte from the stack and place it in a register. The S register 
keeps track of the byte in the stack that is currently ready 
for use. 

• A processor status register, calted the P register. Seven of 
the eight bits of this register store flags that record the 
outcome of processor activities, and that can be checked by 
later instructions to determine what the processor should do 
next. 



2,2 Overview of the Address Space 



Soft switches are described: 
sections 2A and 2.5. 



The Apple tic's 65C02 microprocessor can address 65,536 
(64K) memory locations. All of the Apple lie s RAM. ROM, and 
input and output (I/O) devices are accessed using addresses in 
this 64K address range. Some functions have the same 
addresses — but not at the same time. The AppJe lie contrais its 
shared addresses using soft switches. 

Note: When referring to memory space, K stands for 1024, 
which is 2 to the tenth power. It is called K because 1024 is 
very close to the value 1000. which has fong been 
abbreviated K for Kilo, Some early computers even saved the 
extra 24 locations for spares. 

RAM stands for random-access (readable and writable) 
memory. ROM means read-only memory. Refer to the 
Glossary for further information. 



2.2 Overview of the Address Space 
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Thefe are two other ROMs In the 
Apple lie: one to generate 
characters corresponding to 
keystrokes {section 11.7), and 
another to generate characters for 
display (section 11.9). However, 
tnese ROMs are not addfessaUie 
by the microprocessor. 



Ar input and output \r\ the Apple lie Is memory mapped— that is, 
specific memory addresses (ali in the SCO page) are allocated to 
each 1/0 device, in ttiis chapter, the I/O memory spaces are 
described simply as areas ot memory. For details of the built-in 
I/O features and firmware, refer to the descriptions in 
Chapters 3 through 9. 

A block of 256 address locations is called a page. A one-byte 
address counter or B-bit register can specify one of 
256 different locations. Thus, page consists of memory 
locations from to 255 (hexadecimal SO to $FF), inclusive; 
page 1 consists of locations 256 to 51 1 (hexadecimal 
$100 to $1FF); and so on. In this manual, all page numbers 
{except some of the low-numbered ones) are given in 
hexadecimal format. 

Note: The first two digits of a four-digit hexadecimal address 
are the page number. There are 256 pages of 256 bytes each 
in the address space. This kind of page is different from the 
display areas in the Apple lie. which are sometimes referred 
to as Page i and Page 2. 
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2.3 Memory Map and Memory Switching 



Figure 2 2 is a map of the Apple lie's memory address space 
and what the major blocks of addresses are used for. As you 
can see in the figure, addresses $0000 through $COFF contain 
hardware only, and addresses $0100 through $CFFF contain 
ROM only. At all other addresses there are two, three or even 
five blocks of RAM or ROM locations At any given time, only 
one block of RAW or ROM occupies each set of addresses. As 
described later in this chapter, switches in the hardware page 
control which blocks the processor is to use. 



u. 



Isl 



Chapter 2: Memory Organization and Control 



^ 
f 
E 
^ 



Figure 2-2. ApptS He Memory Msp 
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2.3 Memory Map and Memory Switching 
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2.3.1 Main RAM Addresses ($OOO0-$BFFF and 
$DOQO-$FFFF) 

The area labeled Main RAM in Figure 2-2 is so-caHed because 
some or all of it is present in all models of the Apple II series of 
computers. The Apple lie has 64K bytes of main RAM, 

2.3.2 AuxiUary RAM Addresses ($OO0O-$BFFF and 
$DOO0-$FFFF) 



2,3.3 ROM Addresses (SCIOO-SFFFF) 



Pages $C1 through CF (addresses SCI 00 through $CFFF) 
contain I/O firmware. The following associations apply for the 
Apple lie: 

• Senal port 1 {RS'232 device) firmware entry points are on 

page ic^. 

• Serial port 2 (communication device) firmware entry points 
are on page SC2. 

• Video output firmware entry points are on page $C3; the 
enhanced video firmware and miscellaneous I/O support 
routines occupy pages $C8 through SCF, 

• Mouse firmware entry points are on page $C4, 

• Disk I/O firmware entry points are on page SC6, 
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The Appte lie has another 64K of auxiliary RAM buift in. Some 

or all of auxiliary memory is present in an Apple He ywith one of 

the eO-column cards installed (Appendix F), but there is no ^ 

auxiliary RAM in the Appie II or If Plus. This portion of RAf^ ^ 

cannot be used simultaneously with main RAM: you must use 

the soft switches described in this chapter to select main or J 

auxiliary memory for a given range of addresses. K 



fe 



ROM addresses contain the built-in Apple He firmware. 
Addresses $C100 through $CFFF belong exclusively to ROM- ^ 

Addresses $D000 through SFFFF are shared by ROM, main Uj- 

RAM, and auxiliary RAM; the setection techniques are described 
in section 2.4.2. 
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TTie operation of the Applesoft 

Interpreter firmware is described in 
the Appiesoti BAStC Programmer's 
R&fersncs Manual, 



Note: This correspondence of ports and entry points does 
not imply tiiat all of each ports firmware occupies a specific 
page. Tf>e Apple lie I/O port firmware space is allocated in a 

way tfrat provides the best possible performance. 

Pages SDO through $F7 (addresses SDOOO through !BF7FF) 
contain the AppEesoft Interpreter firmware. 

Pages SFS through SFF (addresses SF800 through $FFFF) 
contatn the Monitor^ which is described in Chapter 10. Monitor 
routines that make various input and output procedures easier 
are described in Chapters 3 through 9. 





Chapters 3 through 9 describe the 
Appfe lie's fnpjt and output 
locations. Appendix S lists all of 
these locations in address order, 
rather than by function. 



Bit num&ering in a byte is 
explained in Appendix H. 



2.3.4 Hardware Addresses ($COOO-$COFF) 

The Apple lies built-in input and output functions, and the 
switching of blocks of address space, ail take place via locations 
on the SCO page— that is. in the address range SCOOO through 
$COFF. This chapter describes the address space (memory) 

switches. 

The hardware functions on this page fall into five basic 
categories; 

• Data inputs. The only data input is location $C000, where 
the low-order seven bits (bits 6 through 0) represent the 

keyboard key just pressed. (This data is guaranteed valid 
only when bit 7 = 1.) 

• Flag inputs. Most built-in input locations are single-bit ffags 
in the high-order (bit 7) position of their respective memory 
addresses. Flags have only two values; on (greater than or 
equal to 128 or SBO) or off (less than 128 or $80). 

The switch, hand controller (analog) and button inputs, and 
the keyboard strobe, are examples of flag inputs. The 
locations for reading soft-switch states are also of this type. 

• Strobe outputs. The clear keyboard strobe (Chapter 4) and 

paddle timer strobe (Chapter 9) outputs are controiJed by 
memory locations. If your program reads the contents of one 
of these locations, then \hB function associated with that 
location will be activated. 
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Toggle switches. The Apple ilc has only one toggle switch: 
the speaker switch. A toggle switch has only one address 
assigned to it; each time you access it^ it changes to Its 
other state (on or off). 

Reading the speaker toggle at location $C030 dicks the 
speaker once. However, if you write to the speaker location, 
the microprocessor activates the address bus twice during 
successive clock cycles, causing the speaker toggle to end 
up in its original state before the speaker cone can move- 
Therefore, you should read, rather than write, to use this 
device. 

The processor cannot read the on/off status of the speaker 
switch. 

Soft switched. Soft switches are two-position switches 
turned on by accessing one address and turned off by 
accessing another address. Most of these switches have a 
third address associated with them for reading the state of 
the switch. 

There are eight soft switches that select different 
combinations of bank-switched memory (section 2.4). Four of 
these eight switches require that your program read them 
twice in succession to activate them. 
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2.4 Bank-Switched Memory 






The Stack and zero page are 
switched this way so that system 
software running in the 
bank-switched memory space can 
maintair Its own stack and zero 
page while it manipulates the 48K 
memory space {section 2.&}- 



Section 2.4.1 discusses what 
tunctiors various addresses are 
sel aside Hor; section 2 4.2 
describes how to select the 
memory banks you wanl. 



The memory areas described in this section are called |§ 

bank'Swilched memory (Figure 2-3) because so many banks 
(ranges) of addresses— one bank of ROM and up to four banks ^ 
of RAM— occupy the same group of locations among the upper Ki 
addresses of memory. Pages $00 and $01 . at the low end of 
memory, are included here because the two sets of them— one ^ 
in main RAM and one in auxiliary RAM— are controlled by the II 

same switches as the high-address banks. 
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Figure 2-3. Bank-Switch&d Memory 
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2.4 Bank-Switched Memory 
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See TabJe B-1 in y^pendix B- 



Ali these msmory banks are 
controlled by the solt switches 
descfi&ed in section 2.4.2. 
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2.4.i Page Allocations 

Pages zero and one are used by many of the 55C02 
instructions. The ROM and RAM addresses in bank switched 
memory are usualiy occupied by system software such as 
interpreters, compilers, and operating systems. 

Page $00 (One-Byte Addresses) 

Several of the 65C02 microprocessor's addressing modes — for 
example, indirect addressing— require the use of addresses In 
page 2ero, or zero page. However, the Monitor, the Interpreters, 
and the operating systems all make extensive use of page zero. 
too. One way to avoid conflicts is to use only those page-zero 
locations not already used by these other programs. But there 
is another way. 

As you can see from Tabie B-1, page zero is pretty well used 
up, except for a few bytes here and there. Rather than trying to 
squeeze your data into an unused corner, you may prefer a 
safer alternative: turn off interrupts, save the contents of part of 
page zero, use that part, then restore the previous contents to 
page zero, restore interrupts to their previous state, and then 
pass control to another program. 

Page $01 (The $5C02 Stack) 

The 65C02 microprocessor uses page 1 as its stack — a place 
where it can store subroutine return addresses, in last-In, 
fIrst-out sequence. Programs can aiso use the stack for 
temporary storage of registers {via push and pull instructions). 
However, programs should use the stack carefully. 

Pages $D0 Through $FF (ROM and RAM) 

Tine memory address space from SDOOO through SFFFF is used 
for both ROM and RAM. The 12K bytes of ROM in this address 
space contain the Monitor and the Appiesoft BASIC interpreter. 

There are 16K bytes of main RAM in this 12K space, with two 
banks occupying the 4K of addresses from SDOOO through 
SDFFF. The RAM is normaliy used for storing other languages 
such as Pascal, or operating systems such as ProDOS. 

There are also 16K bytes of auxiliary RAM in this 12K space, 
again with double occupancy iin the address range $D000 
through $DFFF. 
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2.4,2 Using Bank Selector Switches 

You switch banks of memory in the same way you switch other 
functions in the Appie lie: by using soft switches. These soft 
switches do four things: 

1. Select either RAM or ROM in this memory space. 

2. Allow or inhibit (w rite-protect) writing to the RAM when RAI\A 
is selected, 

3. Select the first or second 4K-byte bank of RAM in the 
address space SDOOO to SDFFF. 

4. Select either main RAM or auxiliary RAM, 



Warning 

Do not use soft switches without carefuf ptanntng. Careless 
switching between RAM and ROM is a/most certain to have 
catastrophic effects on your program. 

Tabfe 2-1 shows the addresses of the soft switches for 
seiecting all allowed combinations of reading and writing in this 
memory space, and the addresses of the iocatfons to read the 
switch settings. Figures 2-4 through 2-10 illustrate how to select 
the combinations and what the resulting status of each switch 
is. 

To nnake sure you do not inadvertently remove write protection 
from bank-switched RAM. the four write-enable addresses 
require that you read them twice in succession (indicated by RR 
in Table 2-1)- 

Because the ALT2P switch shares the read keyboard address, 
you must write (W in Table 2-1) to its iocations to change the 
switch setting. 

To find out which way a switch is set, read the appropriate 
location and then check bit 7 (shown as R7 in Table 2-1 }. If the 
bit is a 1 , the answer to the question given in the table is 
affirmative. 

Note: There is no way to check whether write protection is " 
on or off. 
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T&dte B-1. Bsnk Select Switches 
Action Hex Name 

R scoeo 



RR 

R 

RR 



R7 



scoei 



SC0S3 



Function 

Read RAM; no write; use SDQOO 
bank 2. 

Read ROM; write RAM; jse 

$D0O0 bank 2. 

Read ROM; no write; use $DO00 
bank 2. 

Read and write RAW; use SCKJOO 
bank 2. 



R 


$C0&8 




Read RAM; no write, use $DOOQ 

bank 1. 


J 


RR 


SC089 




Read ROM; write RAM; use 

SDOOO' bark 1. 


i- 


R 


SC08A 




Read ROM; no write; use SDOOO 
b&nh 1. 


ir- 


RR 


SCOBB 




Read and write RAM: use $DDOO 
bank 1. 


^ 


R7 


SC011 


RDBNK2 


Head whether $0000 bank 2 (It or 
bank 1 {0) 


R7 


$C012 


RDLCRAM 


Reading RAW (1) or ROM {0). 


^ 
^ 


W 
W 


$cooa 

$C009 


ALTZP 

ALTZP 


Off: jse main bank, page and 
page 1. 

On: use auxiliary bank, page 



$C016 RDALTZP 



and page 1- 

Read whetlier auxiiiary |1]i or 
main (D) bank. 



"26l 



Chapter 2: Memory Organization and Control 






Es 



Figure 2-4. Read ROM 
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Figure 2-S. Read ROM, Write RAM, and Use First $D0 Bank 
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FiguFe 2-S. R&aa ROM. Wnts fiAM. and Use Second $D0 Bsnk 
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Read r«auitl nfi! status: 
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R7 SC012 HeadENLCRAU;bH 7= 1 









Legend: 
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Figure 2-8. Read HAM and Use Second SDO B&nk 
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Legend: 
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F/guw ^- 10. Read ana \NmQ HAM and Use Second SDO Bank 

Seleci rrwfflory: 

W *CDOB Turr <M ALTZP 

RR $C0S3 
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Auxiliary RAM 




Read riBSulling scorns: 

RT JCflia RBBd *LTZP; bll 7 - 
B7 $C011 Repd BANKZ: bil 7 = 1 
H7 $C012 RMaEWLCRAM;6lt7-^ 1 



Read resulEling slQEUS 

R7 SC0 1 6 Road ALTZP; bit 7 - t 
fl7 $G011 PeadBANKS; bll? ^ 1 
n7 SC012 ReadENLCflAMilMt?- 1 



Read rtWfrtory I J — IneclitKB memory 

Write imemorv R = Reed 



HT - Read. cJieck 01: 7 
W = Write 



f*Ft - R«aa iwic^'in Eucces9l4n 
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2.5 48K Memory 



Section 2.5.1 describes the 
memory pag«s the hardware and 
firmware use for various purposes, 
Sections 2.5.2 and 2.5.4 explain 
how to select main or auxihary 
RAM for read/wrile and video 
storage, respectively. Section 2.5.3 
tells you now to use firmware 
routines to transfer data or 
program comrol between main and 
auxiliary RAM, 



Note: You cant read one RAM bank and write to the other; if 
you select either RAM bank for reading, you get that one for 
writing as we!L However, you can read ROM and write RAM 
(Figures 2-5 and 2 6), which makes it easy to transfer 
firmware to l^ank switched RAM if you want to use it with a 
program there. 



The 48K memory space (actually. i7-1/2K) extends from 
location £200 to location SBFFF (Figure 2-11) in both main and 
auxiliary RAM. The amount of storage available in this address 
space depends on what language or operating system you are 
using, and what video display needs your program has. 
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Figure 2-11. 48K Memory Mep 
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Auxiliary RAM 
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The term system refers to the 
computer and iis rimnware pUs 
whatever Dperatirg system you are 
using, 



A buffer is any storage area set 
aside tor one program or devtce to 
put information into and anolfier lo 
take information out of at a 
different time or rate 



Refer to Appencjix D and to the 
apprDpriatg programmer and 
reference manuialB for operating 
system u&e qf page 3. 

Global storage refers to an area 
reserved lor infarmatior that 

programs use in common. 
Vectors^the addresses ot special 
routines — are examples of this 
kind of information. Section 2.6 
discjsses the globaC storage and 
vectors found on page S03. 



See Chapter 5- 



See section 3.4.6 



2.5. 1 Page Aiiocations 

Most of the Apple lie s 48K RAM is available for storing your 
programs and data However, a few RAM pages are reserved 
for the use ot the Monitor firmware, the Applesoft BASIC 
interpreter, and whatever video dispiay you may select- 
Note: The system does not prevent your using these pages, 
but if you do use them, you must be careful not to disturb 
ttie system data they contafn. 



Page $02 (The Input Buffer) 

The GETLN input routine (sectoti 3.2.3) uses page 2 as its 
keyboard-input buffer. The size of this buffer (256 bytes) sets 
the maximum size of input strings read by Applesoft or the 
Monitor. If you know that you won't be typing any long input 
strings (more than, say, 30 characters), you can store 
temporary data at the upper end of page 2. 



Page $03 (Giobai Storage and Vectors) 

The Monitor and operating systems use parts of page 3 for 
global storage and vectors. Table 2-7 shows the part of page 3 
the built in firmware uses- 



Pages $04 Through $07 (Text and Low-Resolution Page 1} 

The most often used display buffer is the Text and 
Low-Resoiution Graphics Page 1 (TLPl in Figure 2-11), which 
occupies main memory pages S04 through $07. It is not usabie 
for program and data storage if you are using Monitor routines 
or Applesoft, or with almost any other program that uses text 
or Jow resolution display. 

Text and Low Resolution Page IX (TLPl X) is an identical 
display page occupying auxiliary memory pages $04 
through $07. This pair of Text and Low- Resolution graphics 
pages are used together to produce 80-column text display. 

There are 128 locations in pages $04-S07 {64 in main RAM, 
64 in auxiliary RAM) that are not displayed on the screen. 
These locations are called screen holes. 
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Warning 

The screen holes are reserved for use by the buHt-in firmware. 



Pages $08 Through SOB (Text and LowPesoiution Page 2) 

The second Text and Low-Resolution Graphics display 
buffer, TLP2, occupies mam memory pages S08 through $0B, 
Most programs do not use Page 2 for displays, but TLP2 is 
there for display use if required. 

Text and Low-Resolution Page 2X (TLP2X) is an identical 
display buffer occupying pages SOS through $0B m auxiJiary 
memory. 

Note: Apple lie firmware does not provide a way to use the 
second pair of Text and Low- Resolution graphics pages for 
SO'Column te^t display. 



Serial port 2: see Chapter 8. 



See Chapter 5. 



Page $08 (Communication Port Buffers} 

Serial port 2 uses the first half of auxiliary memory page $08 
(addresses S0800 through SD87F) as a keyboard input buffer, 
and the second half of the page (addresses S0880 through 
SOBFF) as a serial input buffer. These buffers increase the data 
transfer rates possible with the serial communication port. 
Appendix E explains how to use these features. 

If your program does not use this page for buffers, it can use it 
as part of TPLX. 

Pages $20 Through S3F (High-Resolution Page f) 

The primary high-resolution-graphics display buffer, called 
High-Resolution Page 1 (HRP1). occupies the 32 memory pages 
from $20 through $3F (locations $2000 through S3FFF). If your 
program doesn't use high-resolution graphics, this area is 
usable for programs or data. 

High-Resoiutton Page 1X (HRPlX) is an identicai display page 
occupying auxiliary memory pages $20 through $3F. 

The Apple lie can display double-high-resolution graphics by 
interleaving HRP1 and HRP1X. 
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For more information about Ihe 
display buffers, see Chapter 5. 



▲ 



For details, refer to section 2.5.4. 



Pages $40 Through $5F (High-Resotution Page 2} 

High-Resolution-Graphics Page 2 occupies main memory 
pages J40 through $5F (locations $4000 through $5FFF}. Most 
programs use this area for program or data storage. However, 
it is also available as a second high-resolution page. 

Hlgh-Resolution^Graphics Page 2X (HRP2X) occupies auxiliary 
memory pages $40 through S5F. 

Note: Apple lie firmware provides high-resolution graphics 
routines for HRP1 and HRP2 only. Refer to the Applesoft 
BASIC Programmer's Reference Manual. 



2.5.2 Using 48K Memory Switches 

Two switches select main or auxifiary RAM in the 48K memory 
space (Table 2-2): RAMRD determines which to use for 
reading, and PAMWRT determines which to use for writing. 
When these switches are on, they select auxiliary memory. 
When they are off, they select main memory. 



Warning 

Ttiis discussion assumes that the 80STORE switch, used to 

control display memory, is off. 



Each switch has three locations assigned to it: one to turn it on. 
one to turn it off, and a third to read its state. Because the 
memory locations for turning the switches on and off are 
shared with keytiioard reading functions, you must write to these 
addresses to use them for memory switching. 

For each switch, you can read bit 7 at its third location to check 
whether the switch is on or off. If the switch is on. bit 7 is 1; if 
the switch is off. bit 7 is 0. 

Figures 2-12 and 2-13 illustrate how the switches work. 
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Tabic 2-2. 4BK Memory Switches. Note: 30STORB must be Off TO switeh all 

memory in this fsnge. including display memory (Tabfe 2-6). 



Action 


Hex 


Name 


Function 


W 


SCQ02 


RAMRD 


Oft: read main 4eK RAM. 


W 


SC003 


RAMRD 


On: read auKilJary 4BK RAM. 


fl7 


SC013 


RORAMRD 


Read whether main (0) or auxiJiary 
0) 


W 


$C004 


RAMWRT 


Off: wrile to mafn 4eK RAM. 


W 


*C005 


RAMWRT 


Or: write 1o auKiliary 4SK RAM. 


R7 


SC014 


RDRAMWRT 


Read whethBr main fO^ or auxiJiary 



(1) 



Figure S-1S. 48K RAM Seiection: Spin Pairs 
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Read from main memory 
Write to auxillai^ memory 

AuKiFiary RAM 
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Select memory: 
W $0000 

W SC003 
W $G004 

Main RAM 

r 



Turn oHSOST ORE 

Read from auKilisrv memory 

WrSle to main memory 

Ajxiiiary RAM 

r 










Read resulting Stat js: 

R7 IC018 Read COSTORE; bit 7 = 
R7 $C013 Read RAMRD; bit? = 
R7 $C014 Read RAMWRT; bil 7 *• 1 



I -,^j 



Read resuliing status: 

R7 $COia Read 80STORE: bl! 7 - a 
R7 SC0 13 Read RAMRD; bEt 7 - 1 

R7 SC0 1 4 Read RAMWRT; bit 7 = 



Legend: 



^ Read memory 
= Wrile memory 



= Inactive memory 
R =■ Read 



R7 • Read, check bit 7 

W - Write 
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Figure 2-13^ 4ffK RAM Selection: One Stcfe Onfy 
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Read resulting status: 

R7 SC018 Read SOSTORE; bll 7 = 
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R7 $C014 Read HAMWRT: bit? - 



S@tect memory: 

W $CO0O Turn off SOSTORE 



W $C003 
W $G005 



Read Irom auxiliary memory 
Write to auxiliary memory 



Main BAM 


Au 

r 


xiliary RA 


M 


1 






-T-- 


^TLP2 
■^TLPI 


1 1 

1 — 1 — 










■ 


^ T] Pis: 


HRP2 


S 


HRPl 


Jh^^? 




^^ 




soivyvvv./ 




;^^^ssHSsa 






1. 1 




' ' 



Read resulting status: 

R7 SCO ie Read SOSTORE: bit 7-0 
R7 EC013 Read RAMRD; bit 7 = 1 
R7 SC0 1-4 Read RAMWRT; bit 7 = 1 



Legend: 



= Read memory ] | = Inactive memory R7 = Read, check bit 7 

= Write memory R = Read W - WrEte 
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2.5.3 Transfers Between Main and Auxiliary Memory 

tf you want to write assembly-language programs that use 
auxiliary memory but you don't want to manage the auxiliary 
memory yourself, you can use the built-in 48K RAM transfer 
routines. These routines make it possible to move between 
mam and auxiliary memory without having to manipulate the 
soft switches described In Section 2,5.2. 

Note: The routines described below make ft easier to use 
auxiliary memory, but they do not protect you from errors. 
You still have to pfan your use of auxiliary memory to avoid 
catastrophic effects on your program. 



Tabte 2-3. 4SK RAM Transfer Roufines 
Action Hvx Name 

JSn $C311 VIOVEAUX 



JMP 



SC314 XFER 



Function 

Moves da!a blocks betwe&n mam 
and auxiliary 40K memory. 

Transfers program control 
between main and auxiliary 
48K memory. 



Transferring Data 

In your assembly-language programs, you can use the built-in 
routine named MOVEAUX to copy blocks of data from main 
memory to auxiliary memory or from auxiliary memory to main 
memory. Before calling this routine, you must put the data 
addresses into byte pairs in page zero and set or clear the 
carry bit to select the direction of the move. 

Warning 

Don't try to use MOVEAUX to copy data sn bank-switched 
memory (page zero, page one or pages $D0 through $FFl 
MOVEAUX uses page ^ero aft during the copy. 

The pairs of bytes you use for passing addresses to this routine 
are called A1. A2. and A4. and they are used for parameter 
passing by several of the Apple lie s built-in routines. The 
addresses of these byte pairs are shown In TabJe 2-4. 
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Tubte 2-4. Perimeters for MOVBAUX Routine 



Name 


Locstiofi 


Parameter Passed 


l^ 


Carry 




1 = Move from main to auxitiar^ 
memory 

= Move from auxiliary to main 

memory 


? 


AIL 


S3C 


Source starting address, low-ordBr 




AIM 


$3D 


Source staring addro&Bn high-ordw 

byte 




A2L 


t3E 


Source ending address, low-ordw 

byte 



A2H 

A4L 
A4H 



$43 



Source ending address, high-order 
byte 

Destination starting address, 
low-order byte 

Destination starting address. 
hlgti-order byte 



X,¥,A Ttie&e registers are preserved 

Put the addresses of the first and last bytes of the block of 
memory you want to copy into A1 and A2, Put the starting 
address of the biock of memory you wart ti3 copy the data to 
into A4* 

Ttie MOVEAUX routine uses the carry bit to select the direction 
to copy the data. To copy data from main memory to auxiliary 
memory, set the carry bit (SEC instruction); to copy data from 
auxiliary memory to main memory, clear the carry bit 
(CLC instruction). 

When you make the subroutine call to MOVEAUX, the 

subroutine copies the block of data as specified by the 

A register and the carry bit. When it is finished, the accumulator 

and the X and Y registers are just as they were when you caJied 

it. 
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Transferring Control 

You can use the butit-in routine inamed XFER to transfer control 
to and from program segments in auxiliary memory. You must 
set lip three parameters before using XFER: the address of the 
routine you are transferring to, the direction of the transfer, and 
which page zero and stack you want to use. 
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Tsbie 2-5. Parameters lor XFER Routine 



Name or 
Location 

Carry 



Overt\o'*f 



Parameter Passed 



S3ED 
E3EE 

X.Y.A 



1 » Transfer from main to 
auKillary memory 

— Transfer from auKiiiary to 
main memory 

1 = Jse page zero and stack tn 
auKiiiary memory 

= Use page zero and stack in 
main memory 

Pfogram stansng addresSr 
low-order byte 

Program starting address, 
high-order byte 

These registers are preserved. 



Refer to Appendix E for 

Instructions on how to do this 



Put the transfer address into the two bytes at locations $3ED 
and $3EE. with ttie low-order byte first, as usuaL The direction 
of the transfer is controlled by the carry bit; set the carry bit to 
transfer to a program in auxiliary memory; clear the carry bit to 
transfer to a program in mam memory. 

Use the overflow bit to select which page zero and stack you 
want to use: dear the overflow bit to use the main memory; set 
the overflow bit {cause an overflow condition) to use the 
auxiliary memory. 

After you have set up the parameters, pass control to the XFER 
routine by a jump instruction, rather than a subroutine call. 

Warning 

!t rs your responsibility as the programmer to save the current 
stack pointer before using XFER and to restore it after 
regaining control Failure to do so wiU cause program errors 



2.5.4 Using Dtspiay Memory Switches 

Sectton 2.5.2 discusses how to select main or auxiliary RAM 
for the 4SK memory space. However, under many 
circumstances your program may want to control reading and 
writing to display pages separately. The switches discussed in 
this section overhde the effects of RAMRD and RAMWRT for 
display pages onfy. 
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One of the switches, 80STORE, Three switches are involved in the display page selection 



shares its on and off addrssse^ 

with a ke/board reading furctfar. 
As a result, your program must 
wriite to lliese locations to turn the 
switch on and off 



process. Each of them has three locations assigned to it: one to 
turn it on, one to turn it off, and a third to read its state 
(Table 2-6). 

For each switch, you can read bit 7 at its third location to check 
whether the switch is on or off. If the switch is on, tit 7 is 1; if 
the switch is off, bit 7 is 0, 

Here is how these switches work for reading and writing. 

• If HIRES is off, then PAGE2 switches between Text and 
Low-Resolution Graphics (TLP) pages only. If HIRES is on, 
then PAGE2 switches between TLP pages and 
High-Resolutton Graphics (HRP) pages. 

• If 80STORE is oft, RAMRD and RAMWRT (Table 2-2) 
determine whether main or auxiliary RAM iocations are used, 
PAGE2 selects pages for display (Chapter 5), but not for 
reading and writing. 

• If BOSTORE IS on, it overrides RAf^RD and RAMWRT with 
respect to the display pages selected by HIRES and PAGE2 
(Figures 2-15 and 2 16). 
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Table 2-e. Display Memory Switches 



See Chapter 5 far a discussion of 
text and high-resolution page and 
the iiigh-resolution pageSr 



Action 


Hex 


Name 


Function 


W 


5C000 


easTORE 


Off; RAMRD and RAMWRT 
determine RAM locations. 


W 


$C001 


SDSTORE 


On: PAGE2 switclies between 
TLP1 and TLP1X and (if HIRES 
or} between HRPi and HRPIX. 


R7 


$C01B 


RDBOSTORE 


Read winelher 8Q3TORE on (11 or 
off tO) 


R 


$C054 


PAGE2 


Ofi: select TLP1 and HHPI. 


R 


$C0S5 


PAGE2 


On: if QOSTORE off, switch to 
TLP3, and (if HIRES on) to HRP2. 
H aOSTORE on, switch to TLPIX, 
and Of HIRES on] to HRPIX. 


FI7 


$C01C 


ROPAGE2 


Read whether PAGE2 on (1) or 

off (0) 


R 


SC056 


HiRES 


Off: display text and 
low-FESDlution page_ 


R 


SC057 


HIRES 


On; dispfay high-resoljlion pages 
makB PAGE2 switch between 
high-resolution pages- 


R7 


SCOID 


RDHII^ES 


Read whether HIRES on (1J or 
off (0) 



2.5 48K Memory 



rii" 



r 



mgure 2-14. PAGE2 Selections With 80STOHE On and HIHES Off 

Select rnerflOry: 

W SG001 Tjrn or flOSTORE 

R SC056 Tjrn off HIRES 

R SC054 Turn off PAGES 



Main RAM 
I 1 

f 1 

r I 

I .--H 

> I I 

I ' 1 



High-Resolution 

Graphics Pages 



TsKtand 
Low-ResDlutioir 
Graphics Pages 



HRP2 



HRP1 



mmi -^ 



Auxiliary RAM 

I 1 

r-T-1 
I — ^ — I 



dl 



'TLP2 



'TLP1 



HRP2X 



HRP1X 






'TLP2X 



■TLPIX 



Rea<j resulting status: 

R7 $C018 Read aOSTORE; bit 7 = 
R7 $C01D Read HIRES; bit 7 = 
R7 SCQiC Read PAGE@; bit 7 = 



Sefect memory: 

W $C001 Turn or> aoSTOHE 

R $C056 Turn oH HIRES 

R $C055 Turn on PAGE2 



Main RAM 



I > ( 



I ' 1 




Auxiliary RAM 

I 1 

I ^-1 

I I 

I . — ^-1 

I I 

I 1 



J 




HRP2X 



HRP1X 



Read resulting status; 

R7 SCOie Read eOSTORE; bit 7 = 1 
R7 SCD1D Read HIRES; bit7 = 
R7 SC01C Read PAGE2; bit 7 = 1 



Legend: 



Head memory 
= Write memory 



I = Inactive memory 

llllllll ^ Controlled by RAMRD and 

INNNI RAMWRT {See Figs. 2-12 and 2-13) 



P = Read 
W = Write 
R7 - Read, check bit 7 
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FiSgure 5- 15. PAGE2 SetecUoos Wilh EOSTORE On and HtHES On 

Select memory: 

W $C00 1 Turn on SOSTO R E 

R $C057 Turn on HJRES 

R $C054 Turn Off PAGE2 



Matn RAM 
I 1 



I ^ i 

t I I 

I — ' — i 
I 



High-Resolution 
3raphlcs Pages 



Taxi ard 
Low-Resolution n 
Graphics Pages 
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Auxiliary RAM 
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HRP2X 



HRP1X 



Select memory: 
W SCOOI 
R SC057 
R SC0S5 

Malo RAM 
I 1 

K"! 1 

K I 

\ i 1 

I I I 
I ' 1 



TUrn on eOSTORE 
Turn on HIRES 
Turn on PAGE2 

Auxiliary RAM 
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. TLP2X 
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HRP2 



HRF1 
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■ TLP2 

"TLP1 
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Read resulting status; 
R7 $C01S Read 80STORE; bit 7 - 1 
R7 $CD1D Read HIRES; bit? = 1 
R7 $C01C Read PAGE2; bit 7 = 



Read resufting status: 

R7 $C0t8 Read flOSTORE; btt 7 = 1 

R7 $C01D Read HIRES: bit 7 - 1 
R7 $C01C Read PAQE2; bit 7 = 1 



Legend: 



= Read memory 
= Write memory 



I J Inactive memorv 



Controlled by RAMRD and 

RAMWRT (See Figs. 2-12 and 2-^Z) 



R = Read 

W - Write 

R7 = Read, check bit 7 



F 
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2.6 The Reset Routine 



A procedure caKed the reset routine (Figure 2-16) puts the 
Apple lie into a l^nown state wiien it has just been turned on or 
you hoid down [ contrqlI whiie pressing (reset) . The reset 
routine puts the Appie ilc into its norma] operating mode and 
restarts the program indicated at locations S3F2 
and S3F3 (Table 2-7). 



Figure 2- IB. Reset Routine Flowchart 
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When you Initiate a reset hardware In the Appie Ilc sets the 
memory-controlling soft switches to normal: main ROM and 
RAM are enabied. auxiliary RAM is disabled and the 
bank-switched memory space is set up to read from ROM and 
write to RAIVl, using the second bank at SDOOO. 
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The reset vector vafidity check is 
described in section 2.6.4. 



The reset routine sets the display-controlting soft switches to 
display 40-coiumn text Page 1 using the primary character set, 
then sets the display window equal to the full 40 column 
display, puts the cursor at the bottom of the screen, and sets 
the text display format to normai. 

The reset routine aiso sets the keyboard and display as the 
standard input and output devices (Chapter 3). It masks mouse 
interrupts and sets mouse defaults {Table 9-1). Finaiiy, it 
enables DHIRES switch access (by turning on iOUOtS), dears 
the keyboard strobe, and sounds the speaker. 

The Apple lie has three types of reset: power-on reset, also 
called cold-start reset; warm-start reset; and forced cold-start 
reset. The procedure described above is the same for any type 
of reset. What happens next depends on the reset vector. The 
reset routine checks the reset vector to determine whether it is 
valid or not. If the reset was caused by turning the power on, 
th$ vector will not be valid, and the reset routine will perform 
the cold'Start procedure. If the vector is valid, the routine will 
perform the warm-start procedure. 



2,6.1 The Cold-Start Procedure (Power On) 

If the reset vector is not valid, either the Apple lie has just been 
turned on or something has caused memory contents to be 
changed. The reset routine clears the display and puts the 
string Apple //cat the top of the display. It loads the reset 
vector and the validtty-check byte as described in section 2.6,1, 
then initiates the startup routine that resides in the disk 
controller firmware. The bootstrap routine then loads whatever 
operating system resides on the disk in the built-in drive. When 
the operating system has been loaded, it displays other 
messages on the screen. If there is no disk in the disk drive, 
the drive motor keeps spinning for a brief time. Then the 
firmware shuts it off and displays the message Check Disk 
Er ive at the bottom of the screen, 



If you press [ conthol H reset ] again before the startup 
procedure is completed, the reset routine continues without 
using the disk, and passes control to the Applesoft BASIC 

interpreter. 



2.6 The Reset Routine 



2.6.2 The Warm-Start Procedure (CONTROL-RESET) 

Whenever you press CcontrolX reset] when the Apple lie has 
already completed a cold-start reset, the reset vector is still 
valtd and it is not necessary to reinitialize the entire system. The 
reset routine simply uses the vector to transfer control to the 
program it points to, which at power-up is the Applesoft 
interpreter. 

If the vector does point to the Applesoft interpreter, your 
Applesoft program and variables are still intact. If you are using 
DOS or ProDOS™, that operating system is the resident 
program and it restarts the BASIC interpreter you were using 
when you pressed ( control h reset ). 

Note: A program residing onfy in bank-switched RAM cannot 
use the reset vector to regain control after a reset, because 
upon reset the hardware selects the ROM for reading In the 
bank-switched memory space. 



2.6.3 Forced Cold Start ( O -CONTROL-RESET) 

ff a program has set the reset vector to point to its own 
warm-start address, as described below, pressing 
[comtrolK RESET] causes transfer of control to that program. If 
you want to stop such a program without turning the power off 
and on, you can force a cold-start reset by holding down 
r^oNTROL } and Co), then pressing and releasing (_ reset) . 

Note; When you want to stop a program unconditionally — for 
example, to start up the Appfe lie with some other 
program— you should use the forced cold-start reset, 
rd X CONTROL K RESETS, instead of turning the power off and 
on. 

The forced cold-start reset works as follows. First, it destroys 
the program or data in memory by writing two bytes of arbitrary 
data into each page of main RAfvi, The two bytes that get 
written over in page 3 are the ones that contain the reset 
vector. The warm-start reset routine finds the error, and so 
performs a normal cold-start reset. 
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Note: If you press both CS a'^d QD during power-up or 
rcQMTRQLK RESET 1 built-ifi ©xerclse code is executed. This 
code \s for production and has no end-user value. 




2.6.4 The Reset Vector 

The cold-start reset routine stores the starting, address of the 
built-in Applesoft interpreter, low-order byte first, in the reset 
vector address at locations $3F2 and $3F3. It then stores a 
validity-check byte, also called the power-up byte, at 
location S3F4. The validity-check byte is computed by 
performing an exclusive-OR of the second byte of the vector 
w/ith the constant 165 (hexadecimal $A5). Each time you reset 
the Apple Itc, the reset routine uses this byte to determine 
whether the reset vector is still vaiid. 

You can change the reset vector so that the reset routine wHI 
transfer control to your program instead of to the Applesoft 
interpreter. For this to work, you must also change the 
validity-check byte to the exclusive-OR of the high-order byte of 
your new reset vector with the constant 165 {$AS). If you fail to 
do this, then the next time you reset the Apple lie, the reset 
routine will determine that the reset vector is invalid and 
perform a cold-start reset, eventually transferring control to the 
disk bootstrap routine or to Applesoft. 

There is a subroutine that generates the validity-check byte for 
the current reset vector. This subroutine, called SETPWRC, is at 
location $FB6F, When your program finishes, it can return the 
Apple lie to normal operation by restoring the original reset 
vector and again calling the subroutine to frx up the 
validity-check byte. 
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Tsbte 2-7. Page 

Vector Address 

S3F0 
S3F1 

S3F2 
S3F3 

$3F4 

S3FS 
$3F6 

$3F7 

53F8 
S3F9 
S3 FA 

S3FB 
E3FC 
$3FD 

$3FE 
$3FF 



3 Vectors 

Vector Funcrion 

Address of (he subroutirte thai handles BRK requests 

(normally $59, SFA).. 

Reset vector {see text). 

Poiwer-up byte (see \e*.\). 

Jump irstnjctbn to the subroutine that handles Applesoft S 
commands (normaNy $AC, S58. $FF). 

Jump ins tructron to ihe subroutJne that handles jser 

CcowtrolH T] commands. 

Jump instruction to the subroutine that handles 
non-maskable interrupts (not used on Apple lie). 

Interrupt vector (address of the subroutine thet handles 
Interrupt requests (Appendix E) 
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This chapter is an introduction to the input/output capabilities of 
the Apple lie; the next six chapters discuss these capabilities in 
detail. The remamder of thts chapter outlfnes the common 
elements of I/O processing — standard I/O links and features, 
standard port entry points, protocols and storage locations, and 
direct I/O. 



3, 1 The Standard f/O Links 



When you call one of the character I/O subroutines (GOUT and 
RDKEY), the first thing that happens is an indirect jump to an 
address stored in programmable memory. Memory locations 
used for transferring control to other subroutines are sometimes 
called vectors. In thfs manual, the locations used for 
transferring control to the I/O subroutines are called the 
I/O links. 

In an Apple lie running without an operating system^ each 
I/O link is normally the address of the standard input or output 
subroutine. An operating system will typically place addresses 
of its own I/O routtnes in these link locations instead. 

By calling the I/O subroutines that jump to the link addresses 
instead of calling the standard subroutines directly, you ensure 
that your program will work properly in conjunction with other 
software^ such as the operating system or a device driver. The 
I/O links contafn the addresses of KEVIN and COUT1 if the 
enhanced video firmware is off (flashing checkerboard cursor), 
and of C3KEVIN and C3C0LJT1 if that firmware is on (inverse 
solid cursor). 



3.1 The Standard I/O Links fss" 



Tlie Monitor i& discussed in 
Chapter 10. 



3. 1. 1 Changing the Standard i/O Links 

The standard I/O links are two pairs of locations in the Apple He 
that are used for controlling character input and output. 

Note: Not all operating systems use the standard I/O links. 
For example, Apple Pascal does not use ttiem. 

The link at locations $36 and $37 is called CSW, for character 
output switch. Individually, location S36 is called CSWL {CSW 
Low) and location $37 is called CSWH (CSW High). This link 
holds the starting address of the subroutine the Apple He is 
currently using for single-character output. This address is 
normally $FDFO, the address of routine C0UT1. 

When you issue a PR#n from BASIC or an n CONTROL-P from 
the Monitor, the Apple he changes this tink address to the first 
address in the ROM memory space allocated to port n. That 
address has the form iCnOO. Subsequent calls for character 
output are thus transferred to the firmware starting at that 
address. When it has finished, the firmware executes an RTS 
(return from subroutine) instruction to return control to the 
calling program. Sometimes a PR#n will cause both input and 
output switches to be changed (as in the 80-coiumn firmware). 

A Similar link at locations S38 and S39 is called KSW, for 
keyboard Input switch. Individually, location $38 is called KSWL 
(for KSW low) and location S39 is called KSWH {KSW high). 
This link holds the starting address of the routine currently 
being used for single-character input This address is normally 
$FD1B, the starting address of the standard input routine 
KEVIN, 

When you issue an IN#n command from BASIC or an 
n CONTROL-K from the Monitor, the Apple He Changes this link 
address to SCnOO, the beginning of an I/O firmware subroutine. 
Subsequent calls for character input are thus transferred to that 
firmware. The firmware puts the input character, with its high bit 
set. into the accumulator and executes an RTS (return from 
subroutine) instruction to return control to the program that 
requested input. 

When a disk operating system (DOS or ProDOS) is running, one 
or both of the standard I/O links hold addresses of the disk 
operating system's input and output routines. The operating 
system has internal locations that hold the addresses of the 
character input and output routines that are currently active. 



^ 

C 
^ 



i 

J 



Chapter 3: Introduction to Apple lie I/O 



L 

E 

i: 



L 

1-41 

L 

l: 

E 

l: 

c 

l: 

r 



Refer to the section or input and 
output link addres&es ir the 

operating system manuals lor 
further detaiSs- 



Warning 

If a program that is runrjing with DOS or ProDOS changes the 
standard fink addresses, either directly or via IN# and PR# 
commands, the operating system may be disconnected from the 
system. To avoid this. BASIC programs should issue an empty 
PRINT statement with a carriage return {to be sure that what 
follows begins a new line), theri another PRINT statement 
containing CONTROL -D and the IH# or Pfl# command. 

After changing CSW or KSW, assembty-language programs 
running under DOS should call the subroutine at location $3EA. 
This subroutine transfers the link address to a location inside 
the operating system and then restores the operating system 
link address in the standard link iocation. 



3.2 Standard input Features 



GETLN ali5o provides on-screen 
editing features: see section 3.2.5. 



The Apple lie s firmware includes two different subroutines for 
reading from the keyboard. One subroutine is named RDKEY 
{read key). It calls the current character input routine (that is, 
the one whose address is stored at KSW). This is normally 
KEYIN or C3KEYIN, which accepts one character from the 
keyboard. The other subroutine is named GETLN [get tine). 
GETLN accepts a sequence of characters terminated with a 
carriage return. Thus GETLN allows line-oriented input using the 
current input routine. 



3,2. 1 RDKEY input Subroutine 

A program gets a character from the keyboard by making a 
subroutine call to RDKEY at memory location $FDOC. RDKEY 
passes control via the input link KSW to the current input 
subroutine, which is normally KEYIN, 

RDKEY displays a cursor at the current cursor position, which 
is immediately to the right of whatever character you last sent 
to the display (normally by using the COUT routine, described 

below). 



3-2 Standard Input Features 



fsf 



&- 

3.2.2 KEYIN Input Subroutine ^^ 

KEYIN is the standard input subroutine. When called, it displays *- 
a cursor, waits until the user presses a key, then returns to the 

calling program with the ASCII code of the key pressed in the ^ 

accumulator. B^ 

If the enhanced video firmware is inactive, KEYIN displays a ^^ 

cursor by alternately storing a checkerboard block in the cursor iu 
location, then storing the original character, then the 

checkerboard again. If the firmware Is active, C3KEYIN Inverts _^ 

the character at the cursor position, B^ 

KEYIN also generates a random number. While it is waiting for 
the user to press a key, KEYIN repeatedly increments the 16-bit 
number in memory locations S4E and $4F, This number keeps 
increasing from to £FFFF (65535), then starts over again at 0. 
The value of this number changes so rapidly that there is no 
way to predict what It will be after a key is pressed. A program 
that reads from the keyboard can use this value as a random 
number or as a seed for a pseudo-random number routine. 

When the user presses a key, KEYIN accepts the character, 
stops displaying the cursor, and returns to the calling program 
with the character in the accumulator. 



Table 3-1. 
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3.2.3 GETLN Input Subroutine 

Programs often need strings of characters as input. While it is 

possible to call RDKEY repeatedly to get several characters ^^^ 

from the keyboard, there is a more powerful subroutine you can jMn 
use. This routine is named GETLN, which stands for get iine. 

and it starts at iocation SFD6A. Using repeated cails to FIDKEY, ^^^ 

GETLN accepts characters from the standard input }j^ 
subroutine— usually KEYIN— and puts them into the input buffer 

Section 3,2 5 describes other located in the memory page from $200 to $2FF GETLN also ^^ 

features of GETLiM. provides the user with on-screen editing and control features. il|^ 

The first thing GETLN does when you call it is to display a 
prompting character, called simply a prompt. The prompt 
indicates to the user that the program Is waiting for input. 
Different programs use different prompt characters, helping to 
remind the user which program is requesting the Input. For 
example, an INPUT statement in a BASIC program displays a 
question mark (?) as a prompt. The prompt characters used 
by the different programs on the Apple lie are shown In j^ 
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Control charsctBrs echo&a by 
GETLN are no! executed. 



GETLN uses the character stored at memory location $33 as 
the prompt character, In an assembly-ianguage program, you 
can change the prompt to any character you wish, In BASIC, 
changing the prompt character has no effect, because both 
BASIC Interpreters and the Monitor restore it each time they 
request input from the user, 

Noter Applesoft uses GETLN1 ($FD6F) when a program is 
executing, GETLN1 does not print a prompt 

Tsbte 3- 1. Prompt Characters 

Prompt 

Character Program Reque&ttng Input 

7 Users BASIC program (INPUT statement) 

1 Applesoft BASIC (Appendix D) 

> Iniegec BASIC (Appendix D) 

• Firmware Monitor (Chapter 10} 

As the user types each character. GETLN sends the character 
to the standard output routine — normally COUT1 — which 
displays it at the current cursor position and then advances the 
cursor to indicate the next character positiori. 

GETLN stores the characters in its butter, starting at memory 
location $200 and using the X register to Index the bufler. 
GETLN continues to accept and display characters until the 
user presses (returnj (or ( control > f)r) to cancel the line). Then 
it clears the remainder of the line the cursor is on. stores the 
carriage-return code to mark the end of the buffer, places the 
cursor at the beginning o1 the next line, and returns. 

The maximum line-length that GETLN can handle is 
255 characters. It the user types more than this, GETLN sends 
a backslash (\) and a carriage return to the display, cancels the 
line it has accepted so far, and starts over. To warn the user 
that the line is getting full, GETLN sounds a bell (tone) at every 
keypress after the 24eth. 

Note: The Applesoft interpreter accepts only 239 characters. 
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Esc^ (D or E Clears to the bottom of the 

window; exits from escape mode. 






3.2,4 Escape Codes With GETLN 

GETLN has many special functions that you invoke by typing 
escape codes on the keyboard. An escape code is obtained by 
pressing (jsc). releasing it. and then pressing some other key, ^ 
as shown in Table 3-2. |M 

Note: Be sure to release CIsc] right away, if you hold it loo -*« 

long, the auto-repeat mechanism will begin, which may fi^ 

cancel the ESC. 

In escape mode, you can keep using the arrow keys and the S* 

cursor motion keys [Y), Q}, ®. ^^^ ® without pressing [esc 1 

again. This enables you to perform repeated cursor moves by .^ 

holding down the appropriate key. ¥s?" 

When GETLN is in escape mode, it displays an inverse plus 

sign as the cursor. You leave escape mode by typing any key ^^ 

other than a cursor-motion key, ^^ 

Note: The escape codes with the arrow keys are the E^ 

standard cursor-motion keys on the Apple ilc The escape ^^ 
codes with Q), (T), (¥), and ® are the standard 

cursor-motion keys on the Apple II and tl Plus, and are gj 

present on the Apple ilc for compatability. ^^ 






Table 3-2. Escape Coifes WUh GETLN. (1) Cursor-controt key: see !exi (2) This 
code functions onty \A'hen the enhanced video firmware is active. 

Escape Code Function Notes 

(EEC) ® Ctears the window and homes the 

cursor (places it in the upper-left 
corner of Ihe screen), then exits ^^ 

from escape mode. m 

C|sg)(T) Ot © Moves the cursor right one line 

and exits from escape mode. 

(Isc) (¥] or (F) Moves the cursor left one line and Km 

exits from escape mode. 

(ESC) (c) or (T} Moves the cuj'sor down one line — 

and exits from escape mode. b^ 

Chc) (B or o Moves the cursor up one line; exits 

from escape mode. ^ 

(Jsc) (T) or (V) Clears to the end of the IJne: exits g* 

from escape mode. 
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Table 3-2—Cantfms^. Escape Cades With GETLN 



Escape Code 

[EscUij'OrO 

{.Escj © or (T) 
QrCESclC^ 

fisc"] fM] or n^ 



CM)® 



[ ESC ! i CKiWTPgi H Tl 



) C CONTROL K q^ 



Notes 



Function 

Moves the cursor up one line; 1 

remains in escaps mods. 

Moi^es the cursor left one space: 1 

remains in escape mode. 

Moves the cursor right one space; 1 
remabns In escape mode. 

Moves the cursor down one tine; 1 

remains in escape mode- 
Switches to 40-column mode: 2 
activates the enhanced video 
firmware; sets links to G3KEY1N 
and G3C0UT1; restores normal 
window size [Table 3-5); exits from 
escape mode- 
Switches to flO-column mode; 2 
activates the enhanced video 
firmware; sets links to C3KEVIN 
anid C3C0LJT1; restores normal 
window size (Table 3-5); exits from 
escape mode. 

Disables conirol characters; only 
carriage return, line feed. BELL, 
and backspace have an effect 
when printed. 

Reactivates control characters. 

Deactivates the enhanced video 2 

firmware: sets links to KEVIN and 
COUTli restores normal window 
size (Table 3-6): exits from escape 
mode. 

Escape sequences can be used in the middle of an input iine to 
change tine appearance of the screen. They tiave no effect on 
the input iine. 
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For an introduction to editing with 
these features, refer to the 
Applesoft Tiitoriat 



The cursor nnqves even \\ the 
deleted charagter is an {invisibile) 
control characler. Thus it is 
possible for screen alignment and 
buffer alignment to be different. 



Se« sectK>n 3.2.4. 
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3.2.5 Editing With GETLN 

Subroutine GETLN provides the standard on-screen editing 
features used by the BASIC interpreters and ttie Monitor. Any 
program that uses GETLN for reading the keyboard has these 
features. 

Cancel Line 

Any time you are typing a line, pressing ( conti^ol y fJT) causes 
GETLN to cancel the line GETLN displays a backsfash ( \ ) and 
issues a carriage return, then displays the prompt and waits for 
you to type a new line, GETLN takes the same action when you 
type more tlian 255 characters, as described above. 



Backspace 

Wtien you press Q (or LcontrqlK TT]), GETLN moves its buffer 
pointer back one space, effectiveiy deleting the last character in 
its buffer. It aiso sends a backspace character to routine COUT, 
which moves the cursor back one space. If you type another 
character now, it will replace the character you backspaced 
over, both on the display and in the line buffer. 

Each time you press CE)i it moves the cursor left and deletes 
another character, untii you are back at the beginning of the 
line. If you then press Q one more time, you have effectively 
canceled the line, and GETLN issues a carriage return and 
displays the prompt. 

Retype 



Q tor ( CONTROL H TQ) has a function that is complementary to 
the backspace function. When you press Q, GETLM picks up 
the character under the cursor just as if it had been typed on 
the keyboard. You can use this procedure to pick up characters 
that you just deleted by backspacing across them. You can use 
the backspace and retype functions with the cursor-motion 
functions to edit data on the display. 
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3.3 Standard Output Features 



The standard output routine is named COUT ^pronounced 
C-out) which stands for character output. COUT normally calls 
COUTI or C3C0UT1, which sends one character to the display, 
advances the cursor position, and scrolls the display when 
necessary. COUTI and C3C0UT1 restrict their use of the 
display to an active area called the text window, described 
below. 

3.3. 1 COUT Output Subroutine 

Your program makes a subroutine call to COUT at memory 
location $FDED with a character in the accumulator. COUT then 
passes control via the output link CSW to the current output 
subroutine, normally C0UT1 or CSCOUTI, which takes the 
character in the accumulator and writes it out. If the 
accumulator contains an uppercase or lowercase letter, a 
number, or a special character, COUTI or C3C0UT1 displays it; 
if the accumulator contains a control character, C0UT1 or 
C3COLIT1 either performs one of the special functions 
described below or ignores the character. 

Each time you send a character to COUTI or C3C0UT1 . it 
displays the character at the current cursor position, replacing 
whatever was there, and then advances the cursor position one 
space to the right. II the cursor position is already at the 
right-hand edge of the window, COUTI or C3C0UT1 moves It 
to the leftmost position on the next line down. If this would 
move the cursor position past the end ot the last line In the 
window, COUTI or C3COUT1 scrolls the display up one line 
and sets the cursor position at the left end of the new bottom 
Una 

The cursor position is controlled by the values in memory 
locations $24 and $25. These locations are named CH, for 
cursor horizontal, and CV, for cursor vertical C0UT1 and 
C3C0UT1 do not display a cursor, but the input routines 
described above do. and they use this cursor position. 
However, changing CV directly will not change the cursor's 
vertical position until the next carriage return or reaching the 
end of the current line causes a call to VTAB (for setting the 
base address within windows). If some other routine displays a 
cursor, it will not necessarily put it in the cursor position used 
by COUTI or C3C0UT1. 
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Escape codes arB described In 
section 3,2.4. 



Warning 

When the video firmware is set for 30-column display, the value 
of CH is kept at and the true hohzontaf position is stored 
at $57 B. When the 80-coiumn video firmware Is active, use 
$57B instead of CM: 



3.3.2 Contro! Characters With C0UT1 

C0UT1 does not display control characters. Instead, the 
control characters listed in Table 3-3 are used to Initiate some 
action by the firmware. Other control characters are ignored. 
Most of tlic functions listed here can also be invoked from the 
keyboard, either by typing the control character listed or by 
using the appropriate escape code. The stop-list function, 
described separately, can only be invoked from the keyboard. 

Tabte 3-3. Controf Characters Wttt^ COUTI. 



"J 



Escape Codes; see section 3,2.4. 



Control 
Character 


ASCII 

Name 


Apple lie 
Name 


Action Taker* by CQUn 


CONTROL-G 


BEL 


bell 


Produces a 1000 Hz tone for 
0,1 second. 


CONTROL- H 


BS 


backspace 


Moues cursor pasilion one space 
tD the left; from leH edge of 
window, moves to right end of 
line above. 


CONTROLS 


LF 


line Feed 


Moves cursor position down to 
next line in windpw; si^rolls if 
needed. 


CONTROL M 


CR 


retum 


Moves cursor position lo lett end 
of next line In window; scrolls if 
needed. 



3,3,3 Control Characters With C3C0UT1 

C3GOUT1 does not display control characters. Instead, the 
control characters listed in the two parts of Table 3-4 are used 
to initiate some action by the firmware. Other control 
characters are ignored. IVIost of the functions listed here can 
also be invoked by using the appropriate escape code. The 
stop-list function, described separately, can onJy be invoked 
from the keyboard. 



-§-■ 



^ 
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Tafyfff 3-4. Control Characters With C3COUT1. (1) Only svaifabfe when enhanced 
vi09O firmwars is active. (2/ Only works from the keyboard. (3) Doesn 't work 
from the keyboard. 



Control 
Character 


ASCII 
Name 


Apple 11c 

Name 


Action Taken by C3C0UT1 


Not 


CONTHOL'G 


BEL 


bell 


Produces a lOOD Hz tone for 
0.1 second 




GONTROL-H 


BS 


backspace 


Moves cursor position one 
space to the leh: from left 
edge of window, moves tn 
right end of line a,bove. 




CON;TROL~J 


LF 


line feed 


Moves cursor position down 
to next line in window; 
scrolls if needed. 




COWTROL-K 


VT 


clear EOS 


Cfears from cjrsor position 
to the end of the screen. 


1,3 


CONTROL-L 


FF 


home 
and dear 


Moves cursor position to 
upper-left corner of window 
and clears window. 


1,3 


CONTROL-M 


CR 


return 


Moves cursor position to lert 
end of next line in window; 
scrolls if need&d. 




CONTflOL-N 


SO 


normal 


S«ts display^ format normal. 


1.3 


CONTROL-0 


SI 


inverse 


Sets display format Inverse, 


1.3 


CONTROL-Q 


DC1 


40-eoEumn 


Sets display to 40-column. 


1.3 


CONTHOL-R 


DC2 


aO-column 


Sets display to BO^column. 


1.3 


CONTROL-S 


DC3 


stop -list 


Slops listiriig characters on 
this display until anpttier key 
IS pressed. 


2 


CONTROL- U 


NAK 


quit 


Deactivates enhanced video 

firmware. 


1,3 


CONTROL-V 


SVN 


scroll 


Scrolls the display down one 
line, leaving the cursor in the 
current position- 


1,3 


CONTROL-W 


ETB 


scroll-up 


Scrolls the display up one 
line, leaving the cursor in the 
current position. 


1.3 


COWTROL-X 


CAN 


disable 

MouseTexi 


Dlsatjle fulouseText 
character display; use 
inverse uppercase- 




CONTROL'Y 


EM 


home 


Moves cursor position to 
upper-left cofner of window 
[but doesn't clear). 


1,3 


CONTROL-Z 


SUB 


cleaf line 


Clears the line the cursor 
position is on. 


1,3 
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Table 3-4—Conrifluea. Control Characters mtn C3C0UT1 



Cortlrol 
Chs racier 


ASCtI 
Name 


Apple Mc 
Name 


Actian Taken by CSCOUTI 


Notes 


J— > 


CONTROL-I 


ESC 


enable 
MoLseText 


Map inverse uppercase 
characters to MojseText 
characters. 




J^ 


CONTROL-\ 


FS 


fwd. space 


Moves cursor position one 
space to the right; from fjgnt 
edge of window, moves in lo 
left end of line below. 


1,3 


UM 


CONTROL-I 


GS 


clear EOL 


Clears from the current 
cursor position to the end of 
the line (that is. to the right 
edge of the window). 


1.3 


UM 


CONTROL _ 


US 


up 


Moves cursor up a line, no 
scroll. 




J 


9^9 A Tha 


Qfnn.t 








l^ 



When you are lising any program that displays text via COUTI ^ 

or C3C0UT1, you can make it stop updating the display by ^u^ 
pressing (control H Tl (tinat is, by holding down Ccomtrol] 

while pressmg ©) Whenever C0UT1 or C3C0UT1 gets a _^ 

carriage return from the program^ it checks for ( control > {T). If ^^^ 

it has been pressed, C0UT1 or C3COUT1 stops and waits for ^ 

another keypress. Then it continues normally. The character _^m 

code of the key you pressed to resume displaying is ignored jfl ^ 
unless it is C control K c^. C0UT1 or C3C0UT1 passes 

CONTROL-C back to the program; if it is a BASIC program, ^ 

this enables you to terminate the program while in btop-list a^ 
mode. 



3.3.5 The Text Window 

After you start up the computer or perform a reset, the 
firmware uses the entire display. However, you can restrict 
video activity to any rectangular portion of the display you 
wish. The active portion of the display is called the text 
window. COUTI or C3C0UT1 puts characters only into the 
window; when it reaches the end of the last line in the window, 
it scrolis only the contents of the window. 
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You can set the top, bottom, left side, and width of the text 
window by storing the appropriate values into four locations in 
memory. This enables your programs to control the placement 

of text in the display and to protect other portions of the screen 
from being written over by new text. 

Memory locatfon $20 contains the number of the leftmost 
column in the text window. This number is normally 0, the 
number of the leftmost column In the display. In a 40-column 
display, the maximum value for this number Is 39 
(hexadecimal S27); in an eO-column display, the maximum value 
is 79 {hexadecimal IB4F). 

Memory location $21 holds the width of the text window. For a 
40 column display^ this value is normahy 40 (hexadecimal $28): 
for an 80 column display, it is normally 60 (hexadecimal £50). 

Warning 

Be careful not to !et the sum of tfie window width and the 
leftmost posftion in the window exceed the width of the display 
you are using (40- or 80-cotumns). if this happens, it is possible 
for COUTI or C3C0UT1 to put characters into memory 
iocatfons outstde the display page, possibly destroying 
programs or data. 

Memory location S22 contains the number of the top line of the 
text window. This is normaHy 0^ the topmost line in the display, 
Its maximum value is 23 (hexadecimal $^7). 

Memory location S23 contains the number of the bottom line of 
the screen, plus 1, It is normally 24 (hexadecimal $13) tor the 
bottom line of the display. Its minimum value is 1. 

Table 3-5 summarizes the memory locations and the possible 
values for the window parameters. 

Warning 

Pascal does not use ihis method of supporting window widths. 
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Tabte 3-S. Text Window Memory Locations 



Window 
Parameter 



Left Edge 

Width 

Top Edge 

Bottom 
Edge 



80cDi. 
Dec Hex 

22 120 



33 
34 

35 



121 

$22 
S23 



Both these dJSplay character sets 
are described in Chapter 5, 



Minimum 

Local ion 



Normal Values: 



Maximum Values: 



Dec 



1 



Hex 



50 
SI 



Value 
Dec Hex 

SO 

40 S30 
$0 

24 S1& 



4QC0I. 

Dec Hen 
£Q 

SO S5Q 
$0 

24 $18 



4Dcal. 
Dec Hex 



39 

23 

24 



$27 
S28 
£17 
S18 



aocoi. *^^ 

Dec Hex ^^ 

79 S4F 

aO E50 ^^ 

23 £17 ZT 

24 51 a 



S.3.6 Normal, immerse, and Flashing Text 

The form of a displayed character depends on two things: what 
value is stored in zero page iocatton S32 (the inverse flag), and 
whether the enhanced video firmware is off or on. The effects 
of the inverse fiag are discussed in the next two subsections. 

If the enhanced video firmware is off, the Apple (Ic displays 
what is called the primary character set; if the video firmware is 
on, the Apple He displays what is called the alternate character 
set. 

The primary character set includes normal (light on dark). 
inverse {dark on light), and flashing (alternating normal and 
inverse) characters. Lowercase inverse characters are not 

included in this set. 

The alternate character set includes normal and inverse 
characters (including lowercase inverse), and a set of icons 
called fviouselext. Flashing characters are not included in this 
set. 

To display a character, load it in the accumulator, and then 
jump to the character-output subroutine COUT. For example, to 
display the character corresponding to $C8 

LDA '$G8 ^^ 

JSR CDUT ^ 

Primary Character Set Display ^^ 

Subroutine C0UT1 {the standard output link when enhanced ^^ 

video firmware is off) can display text in normal, inverse, or 

flashing format, but cannot display inverse or flashing fowercase ^f 

text. ** 
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For a brief eKplanaUon of logical 
tiinctiona. refer to Appendix H, 



MouseText: see Chapter 5. 



See seclion 5.2.2, 



If the value of the character is greater than or equal to $A0, the 
value is logically ANOed with the value of the inverse Mag (at 
location $32), then displayed. 

If the inverse flag value Is 255 (hexadecimal $FF). the character 
is displayed in normal format; if the value Is 63 
(hexadecimal $3F)^ the character is displayed in inverse format. 
If the value is 127 (hexadecimal $7F) the character is displayed 
in flashing format. 

Note: To avoid unusual character display results, use only 
the three values S3F, $7F and $FF. 

Character values from 380 through $9F are interpreted as 
control characters and are executed, if possible 

Character values from SOO through $7F are all display 
characters, not control characters. 

Alternate Character Set Dfspfay 

Subroutine C3COUT1 (the standard output link when the 
enhanced video firmware is active} can display characters in 
normal or inverse format and can display a set of icons called 
MouseText. 

If the character is in the range $00 through S1F or $80 through 
$9F, It is interpreted as a control character and not displayed. 
Values $20 through $7F and SAO through SFF are displayed. 

II inverse flag (location £32) bit 7 is 1 , the character vaiue is left 
alone. If inverse flag bit 7 is 0. the character value is AMDed 
with £7F (turning off bit 7) to make it display as an inverse 
character. 

If MouseText has not been turned on. then the values 
$40 through S5F are mapped to values SOO through $1F, so 
they display as the inverse uppercase set. If MouseText has 
been turned on, the values $40 through $5F are left unchanged, 
and they display as MouseText icons. 



Warning 

Use oniy $3F. S7F or $FF in focation $32. Other values wif! 

cause unpredfCtabie results. 
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3,4 Port I/O 



Apple lie is a member of the Apple II family of computers; 
however, unlike the Apple II, II Plus and lie, the Apple lie does 
not have peripheral connector slots. In place of these, it has 
ports— the equivalent of firmware interface cards installed in 
slots. 



3A. 1 Standard Link Entry Points 

To maintain compalibility with existing software and its 
protocols, each port's I/O firmware has the same standard 
entry points {$CnOO) as its equivalent slot would have. 
Table 3-6 shows these equivalents, as well as listing the 
chapter where each port is described. 

Section 3.1 describes under what conditions these entry 
addresses are placed in CSW and KSW. For example, issuing 
PR'n or I H'n changes the output and input links, 
respectively, so that subsequent output or input is handled by 
the firmware starting at address $CnOO, and thus goes to or 
comes from the selected device. 

Table 3-6. Port Characteristics 



Urn 





Entry 


Port 






Port 


Point 


Connector 


Use 


Chapter 


1 


$C400 


Serial port 1 


Printers 


7 


2 


scaoo 


Serial port 2 


Communication 


e 


3 


$C300 


Video connectors 


Enhanced video 
firmware 


5 


4 


$C400 


Mouse 


Mouse 


3 


5 


SC600 


Reserved 






6 


sceoo 


Disk drives 


BuFFi-in and 
external drives 


Q 


7 


$C70O 


Wo device 


Eitternal drive 
stanup (jnder 
ProDOS only) 


a 



t" 
^ 

^ 
^ 

^ 

^ 



Note: The addresses shown in Table 3-6 are not entry points 
in the sense that you can send characters to be printed by 
sending them to JSR $CnOO, 
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3.4.2 Firmware Protocol 

Besides the standard link address, there is also a standard 
firmware protocol that provides a table of device identification 
and entry points to standard and optional firmware subroiitines 
(Table 3-7). 

Each table begins with identification bytes. Then, starting with 
address SCnOD. each byte in the table represents the low-order 
byte of the entry-point address of a firmware routine. The 
high-order byte of the address is SCn, where n is the port 
number. Using these byte values, a program can construct its 
own jump table for subroutine calls. 

On entry, all routines require that the X register contain SCn 
{n is the port number), and that the Y register contain SnO. 

On exit, all routines return an error code in the X register 
{D means no error occurred; 3 means the request was invalid). 
The carry bit in the program status register usually contains a 
reply to a request code (0 means no: 1 means yes). 

All of the Apple lie ports except the disk port conform to this 
protocoL 
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Table 3-7. 

Address 

$Cn05 

$Cn07 

SCnOB 



Ftrmwars Protocol Locations 

Value Description 



SCnOD 
£CnDE 

sen OF 
$CnlD 

scni 



$18 
$01 



il 
rr 

WW 

as 



Pascal firmware card^port Identifier 
Pascal fifmware card/port identHier 
Generic signature byle of a firmware card/port 

Device signature byte: /is an identifier (not 

necessarily unique). 

c - device class (not all used on the Apple lie): 



$0 
S1 

S2 
S3 



SB-F 



reserved 

printer 

hand control or other X-Y device 

serial or parallel I/O card/pont 

modem 

sound or speech device 

clock 

mass-storage device 

60'Column card/port 

network or bus Interface 

special purpose (none of tne 
above) 

reserved 



SCnti is the initialization entry address {Pit^ilT). 

SCnrr is the read routine entry address (PREAD). 
(Returns character read in A register) 

SCnihrw is the wrrta routine eriry adctress 
(PWRITE), (Enler witti character to write in 
A register) 

£Cnss is the status routine entry address 

IPSTATUS). (Enter with request code in A 
register: to ask "Are you ready to accept 
output?" or 1 to ask "Do you have input ready?" 

$00 IF addl'tional address bytes follow; 
nonzero if not 
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For more information, refer to the 

hardware page memory map in 

Appendix B. 



3.4.3 Pert f/O Space 

By a convention used in other Apple II series machines, each 
port or slot tias exclusive use of sixteen memory locations of 
the form SC080 + #nG, where n is the port or slot number. 
These iocations are set aside for data Input and output. 
Table 3-8 lists the port I/O space used in the Apple lie. 



Table 3-8. Port f/O Locations 


Port 


LocatEons 


1 


SC090-$CQ9F 


2 


SCOA0-5COAF 


6 


SCOEOSCOEF 



3.4.4 Port ROM Space 

In the Apple II and lie, one 256-byte page of memory space is 
allocated to each slot. This space is used for read-only memory 
(ROM or PROM) with driver programs that control the 
operation of input/output devices, as outlined in Table 3-7. On 
the Apple lie. this space is dedicated to port firmware. 
However, I/O ROM space in the Apple lie is used as efficiently 
as possible, and so there is not a strict correspondence 
between firmware for port n and the $CnDO space, except as 
regards entry potnts. 



3.4.5 Expansion ROM Space 

The 2K byte memory space from $C800 to $CFFF in the 
Apple lie — called expansion ROM space on Apple II, II Plus 
and Me — contains the enhanced video firmware and port and 
memory transfer subroutines. Unlike the Apple II, II Plus, or He, 
the Apple lie always has this space switched in. 



3.4.6 Port Screen-Hole RAM Space 

There are 128 bytes of memory (64 In main memory. 64 in 
auxiliary memory) allocated to the ports, eight bytes per port, 
as shown in Table 3-9. These bytes are reserved for use by the 
system, except as described in Chapters 4 through 9. 

These addresses are unused bytes in the RAM memory 
reserved tor text and low-resolution graphics displays, and 
hence they are sometimes called screen holes. These particular 
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locations are not displayed on the screen and their contents are 
not changed by the built-in output routines. In ottier words, they 
are used by ttie output routines but they are not part ot the 
video display. 

Warning 

Aft the screen holes in auxiliary memory, and many of them in 
main memory, are reserved for speaat use by Apple lie 
firmware — for example to store initiaiization information. Do not 
use any locations marked reserved in this manual. 
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T^ttte 3-9. Port Scresn-fioie Memory Locations 



Base 

Address 



Ports 
1 




b 
b 

b 



2 3 4 5 6 7 

S0478 $0479 $047A $Q47B S047C £047D S047E S047F 

S04Fa $04F9 $04FA S04FB $04FC S04FD E04FE $04FF 

$0578 $0579 $057A SD57B $057C $057D S057E S057F 

$05Fa $05 F9 E05F A S05F B $05FC $05FD S05 FE SOS FF 

$0978 S0679 6067A S067B $067C $0B7D $067E S0e7F 

E0GF3 S06F9 E06FA E06FB $06FC SOBFD $06Fe S06FF 

$0778 $0779 $077A S077B $077C S077D E077E $077F 

S07F8 $07F9 $07FA $07FB $07FC S07FD S07FF $07FF 

Port firmware use of these RAM locations and their assigned 
hardware addresses appear in the six chapters that follow this 
one. 



3,5 Interrupts 



AppeodiK E gives a fjll description 
of interrupt handling on the 
Apple lie. 



When the IRQ line on the 65002 microprocessor is activated, 
the 65C02 transfers control through the vector in locations 
$FFFE-£FFFF of ROM or whichever Dank of RAM is switched in 
(Chapter 2). If ROM is switched in, this vector is the address of 
the Monitor's interrupt handler, which determines whether the 
request is due to an interrupt that should he handled internally. 
If so, the Monitor handles it and then returns control to the 
interrupted program. 

If the interrupt is due to a BRK ($00) instruction, control is 
transferred through the BRK vector ($3F0-S3F1). Otherwise, 
control is transferred through the IRQ vector ($3FE $3FF). 
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This chapter describes how to use two of the Apple lie's built-in 
devices: the keyboard and the speaker. 



4- 1 Keyboard Input 



Game input switches: see 
Chapter 9. 



Table 4-1 describes the overall characteristics of the keyboard. 
Monitor [keyboard support includes the three standard input 
routines described in Chapter 3. 

Table 4-f. Keyooara input Characteristics 



Port Number 

Commands 

Indtjal 
Characteristics 



Hardware 
LocaticnS 



$cooo 

$C010 

$C060 

$C061 

$coe2 



None 

Keyboard is aluva/s on, in the sense that any keypress 
generates a KSTRB. 

Reset routine clears the keyboard strobe and sets the 
keyboard as the standard input device (that is. sets KSW to 
point to aOKEY), 



Description 

Keyboard data and strobe 

Any-key-down flag and Clear-strobe switch 

40'Coiurrini switch status on bit 7; 1 = 40-colunnin display - 
switch down 

[dj statjs on bit 7; 1 = pressed (also game input switch 0} 

ft) slatjs on bit 7; 1 - pressed 





4.1 Keyboard Input 



F7 



GETLM, GETLN1. anfl RDKEY; see 
Chapter 3. 



Tabte 4- 1 — Continued. Keyboard input Characteristics 



Monitor Firmware Routines 
Location Name 

SFD6A 

EFQ67 



$FD6F 

$FD1B 
$F035 
SFOOC 
Use of Oth«r 

Pages 



Qe»cfjplion 
GETLN Gets an input line with prompt. 

GETLNZ Gets an inpjt line wrth preceding carriage' 

return. 

GETLN 1 Gets an fnput line, but with no preceding 

prompt 

KEYIN The keyboard input subroutine 

RDCHAR Gets an input character or escape code. 
RDKEY The standard character input subroutine 



Tlie standard character string input buffer (see GETLN 
description) 
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For a dBscription: of how the 
keyboard strobe works, ref>Qr to 
Append! K E. 



4, 1, 1 Reading the Keyboard 

The keyboard encoder and ROM generate all 128 ASCII codes, 
so all the special character codes in the ASCII character set are 
available from the keyboard. Machine-language programs obtain 
character codes from the keyboard by using RDKEY, which 
reads a byte from the keyboard-data location shown in 
Table 4-1. 

Here is how reading the keyboard is done: 

1. To see if a key has been pressed, test bit 7 at 
address SCOOO. 

2. When that bit goes to a 1 , the low-order seven bits are the 
character. 

3. Clear the high bit at $0000 by reading or writing anything to 
address SCOl 0, 

SC010 has another function: its high bit is a 1 whUe a key is 



pressed (except the Apple keys, C control") , (shift; !, {caps-lock") , 
and rRESETl ). Bit 7 at this location is therefore called 
any-k^y-down. 

Any time you read the any-key-down bit at $C010, you also 
clear the keyboard strobe bit at $C000. If your program needs 
to read both the flag and the strobe, it must read the strobe bit 
first. 

After the keyboard strobe has been cleared, \i remains low until 
another key is pressed. 



4.1 Keyboard Input 
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Codes are shown here in 
hexadecimal, to find the decimal 
eqolwatents, refer to section H 6. 
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Table 4 2 shows the ASCII codes for the keys on the Apple lie 
keyboard. If the stroOe bit is set, add $80 to these values. 




Tabte 4-2 


Keys anid ASCI! Codes 












Key 


Normal 

7F 


Cher 

DEL 


ConlTor 

7F 


Char 
DEL 


Shm 

7F 


Cher 
DEL 


Bo»i 

7F 


Char 

DEL 


?* 


(DELfTE] 




09 


B3 

HT 


DB 

09 


BS 

HT 


OB 
09 


B5 
HT 


08 
09 


HT 




s 


QA 


LF 


OA 


LF 


OA 


LF 


OA 


LF 


^^ 


(D 


aa 

OD 

15 


VT 

CR 


OB 
OD 
15 


VT 

CR 
NAK 


OB 

OD 
15 


VT 

CR 


OB 
OD 

15 


VT 
CR 
NAK 


^ 


( RETURr^ f 


use) 


IB 


ESC 


1B 


ESC 


1B 


ESC 


1B 


ESC 




SPACE 


20 
27 


SP 


20 
27 


SP 


20 
22 


SP 


2D 
22 


SP 


^ 


,< 


2C 


1 


2C 


■ 


3C 


< 


3C 


< 


?= 


*_ 


20 


- 


1F 


us 


5F 


^ 


IF 


US 


.> 


3E 




2E 




3E 


> 


3E 


'> 


^ 


/? 


2F 


t 


2F 


/ 


3F 


? 


3F 


7 


0) 

11 


30 

31 




1 


30 
31 


□ 
1 


29 

21 


) 
f 


29 
21 


! 


^ 


2@ 


32 


2 


00 


NUL 


40 


@ 


□0 


NUL 




3# 
4^ 


33 
34 


3 

4 


33 
34 


3 
4 


23 

24 




23 
24 




y^ 


5% 


36 


5 


35 


S 


25 


% 


25 


% 


g= 


6* 


36 


6 


IE 


RS 


5E 


* 


IE 


RS 


7& 


37 


7 


37 


7 


26 


& 


26 


& 


g= 


S» 


as 


G 


30 


S 


2A 


• 


2A 


' 


9( 


39 


9 


39 


9 


28 


( 


28 


( 




;: 


3B 


1 


3e 


' 


3A 




3A 




^ 


= + 


3D 


" 


3D 


= 


2B 


+ 


2Q 


+ 




If 


5G 


[ 


IB 


ESC 


76 


] 


1B 


ESC 


g> 


- 


5C 


\ 


1C 


FS 


7C 


i 


1C 


FS 


1! 


5D 


1 


ID 


GS 


70 


1 
1 


1D 


GS 


ii 




60 




60 
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7E 
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-OmtinueA Keys ancf ASCfl Codes 










K«y 


Normal 


Char 


Control 


Char 


Shin 


Char 


Both 


Chsr 


A 


6t 


a 


01 


SOH 


41 


A 


01 


SOH 


B 


62 


b 


02 


STX 


42 


B 


02 


STX 


C 


63 


c 


03 


ETX 


43 


C 


03 


ETX 





54 


d 


04 


EOT 


44 


D 


04 


EOT 


E 


65 


e 


05 


ENQ 


45 


E 


05 


ENQ 


F 


SG 


f 


06 


ACK 


46 


F 


06 


ACK 


G 


67 


g 


07 


BEL 


47 


e 


07 


BEL 


H 


68 


h 


08 


BS 


4B 


H 


08 


BS 


( 


69 


i 


Od 


HT 


49 


1 


09 


HT 


J 


6A 


j 


DA 


LF 


4A 


J 


OA 


LF 


K 


6B 


ft 


DB 


VT 


4B 


K 


OB 


VT 


L 


6C 


1 


nc 


FF 


AC 


L 


OC 


FF 


M 


6D 


m 


OD 


CR 


4D 


M 


OD 


CR 


N 


6E 


n 


OE 


SO 


4E 


N 


OE 


SO 


a 


6F 





OF 


SI 


4F 





OF 


SI 


p 


7a 


P 


10 


OLE 


50 


P 


10 


DLE 


Q 


71 


q 


n 


DC1 


51 


Q 


11 


DC1 


R 


72 


r 


■J2 


DC2 


52 


R 


12 


DC2 


S 


73 


s 


13 


DC3 


53 


S 


13 


DC3 


T 


74 


t 


U 


DC4 


54 


T 


14 


DC4 


U 


75 


u 


15 


NAK 


55 


U 


15 


NAK 


\l 


7G 


V 


1S 


SYW 


56 


V 


16 


SYN 


w 


77 


w 


17 


ETB 


&7 


w 


17 


ETB 


K 


7a 


X 


18 


CAN 


sa 


X 


1.6 


CAN 


Y 


79 


y 


19 


EM 


59 


y 


IS 


EM 


Z 


7A 


z 


1A 


SUB 


5A 


z 


1A 


SUB 
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Keystrokes can also generate 
interrjpts: se« Appendk E. 



This restarting process is called 
the reset routine', and is described 

ir Chapter 3. 



For information on how to tiave 
programs Interpret keystrokes ir a 
standard way, refer to thi 

Apple it Design Guideilnes listed in 
the Bibliography. 



There are several special-function keys that do not generate 
ASCII codes. For example, you cannot read Cgqntrol) , (shift J , 
and Ccaps-lockI directly, but pressing one of these keys alters 
the character codes produced by the other keys. Programs can 
also read the status ot [_gj and [T] when checking keyboard 
input, and, \\ one or both of them is pressed, branch to a 
special routine, such as a help program. 

Another key that doesn't generate a code is CREsetj , located at 
the upper-left corner o'f the keyboard; it is connected directly to 
the Apple He's circuits. Pressing (resetj with [control ) 
depressed normally causes the system to stop whatever 
program it's running and restart itseif. 

4, 1,2 Monitor Firmware Support 

Cinapter 3 describes the three standard Monitor input routines 
serving the keyboard: GETLN, READKEY and KEYIN. This 
section discusses the three other Monitor routines available. 

OETLNZ 

GETLNZ (at address $FD67) is an alternate entry point for 
GETLN that sends a carriage return to the standard output, 
then continues into GETLN. 

GETLN1 

GETLN1 (at address $FD6F) is an alternate entry point for 
GETLN that does not issue a prompt before it accepts the input 
line. However, if the user cancels the input line with too many 
backspaces or with [ control H YI, then GETLN1 issues the 
prompt at location $33 when it gets another line. 

RDCHAR 

RDCHAR (at address SFD35) is a subroutine that gets 
characters from the standard input subroutine, and also 
interprets the escape codes listed in Chapter 3. 

If the enhanced video firmv^are is active, Q ( { control H TD) 
causes a character to be read from the screen location and 

returned. 
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4.^ Speaker Output 



Electrical specifications of the 
speaker circuit appear m 
Chapter 11, 



The Apple Mc has a speaker mounted toward the front of the 
bottom plate. The speaker is connected to a soft switch that 
toggles: it has two states, off and on, and it changes from one 
to the other each time it is accessed. Table 4-3 descnbes the 
speaker output characteristFcs. 

Tgbi0 4-3. Speaker Output Characteristtcs 



Port Number 


None 


Commands 

Initial 
Characteristica 


Some programs sound the speaker in response to 
CONTROL'G 

Reset routine sourrds the speaker 


Hardware 
Lc^cation 


Description 


EC030 


Toggle speai^er (read only) 


Monitor Firmware 
Location 


Routines 
Name Description 


SFBDD 


BELLI Sends B. beep to the speaker. 


SFF3A 


BELL Sends CONTROL-G to the cjrrent ojtput 



4.2. f Using the Speaker 

11 you switch the speai^er once, it emits a click; to make longer 
sounds^ you access the speaker repeatedly. You should always 
use a read operation to toggle the speaker. ;lf you write to this 
soft switch. It switches twice in rapid succession. The resulting 
pulse is so short that the speaker doesn't have time to 
respond; it doesn't make a sound. 

The switch for the speaker uses memory location SC030. You 
can make various tones and buzzes with the speaker by using 
combinations of timing (oops in your program. 
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4.2,2 Monitor Firmware Support I 

s&e Chapter 3. The Monitor supports the speaker with one simple routine, ^^ 

BELLI. A related routine, BELL^ supports the current output 1 

device — the one that CSW points to. ^M 

BELLI 

BELLI (at address $FDBB) makes a beep through the speaker 
by generating a 1 kHz tone in the Apple lie's speaker for 
0.1 second. This routine scrambles the A and X registers. 



— 1 



BELL 

The Monitor routine BELL (at location SFF3A) wrftes a beil 
control character (ASCII COKTROL-G) to the current output 
device. This routine leaves the accumulator holding $87. 
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NTSC stands For National 
Television Standards Commillee. a 
group that torrriufates broadcast 
ancj reciptiori guidelines used by 
the USA and several other 
coLinlnes. 



Ha 



The primary output device of the Appte lie is the video display. 
You can use any ordinary video monitor, either color or 
monochrome, to display video information from the Apple lie. 
An ordinary monitor is one that accepts composite video 
compatible with the standard set by the NTSC. If you use 
Apple lie color graphics with, for example, a black-and-white 
monitor, the display will appear as black, white, and three 
shades of gray. 

If you are only using 40-calumn text and graphics modes, you 
can use a television set for your video display. If the TV set has 
an Input connector tor composite video, you can connect it 
directly to your AppEe lie; if it does not, you must attach an RF 
video modulator between the Apple lie and the television set. 

Note: The Apple ]lc can produce an eO-column text display. 
However, if you use an ordinary color or black-and-white 
television set, 80-cotumn text will be too blurry to read. For a 
dear 80 column display, you must use a high -resolution video 
monitor with a bandwidth of 14 MHz or greater. 
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Table 5-1 is a summary of the video output port's 
characteristics and a guide to other information in this chapter. 

Table 5-1. Guide to the fnformatfon in This Chapter 



Port Number 

Commands 

tnitial Characteristics 



Hardware Locations 
Monitor Firmware Routines 
ifO Firmware Entrj Pornts 



Output port 3 

Figure 5-3 

Figure 5-2 

Mote: It a program is to jse ihe 

enhanced video ftrmware, it should 
turn il on and then immediately checiit 
the 30'40 switc^i It tihe SMwitcli is in 
the 40 position, ttie program sliould 
issje a CONTROL-Q. 

See Table 5-7 

See Table 5-8 

See Table 5-9 
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5. t Specifications 



Table 5-2 summarizes the specifications for the video display, 
and provides a further guide to other information in this chapter. 



Tabte 5-2. Vt'ifeo Dispiay Specifications 
Display modfls 



Text capacity 
Character set 
Display formats 
Low-resolutron graphics 
Higti-resoiulior graphics 

Dojble-high-resoluiioni graphic^s 



40-column text; map: Figure 5-5 
BO-colUimn text; map: Figure 5-6 

Low- resolution color graphics; 
map: Figure 5-7 

High-resolution color graptiics; 
map: Figure 5 8 

Double-high-resolutlon color graphica; 
map: Figure 5-9 

24 lines by 80 columns (character 
positigns) 

96 ASCII Characters (uppercase and 
lowercase) 

Normal. Inverse, Flashing, MouseTem 
^able 5-3) 

16 colors (Table 5-4) AQ horizontal t>y 

48 vertical: map; Figure 5-7 

S colors (Table 5'5J 140 horizont&» by 
192 vertical (restricted);. 

black-and-wtiile; 260 honzontal by 

192 vertical: rnap: Figure 5-S 



IB colors (Table 5-6) 14D horizontal 
by 192 verttcai (no restrictions); 

black-and-white: 360 horizontal by 
\S2 verlicaf; map: Figure 5-9 

The video signal produced by the Apple He is f^TSC-compatible 
GoiTipo&ite coior video. It is available at two places: ttie 
RCA-type phono jack on the back of ttie Apple lie, and the 
15-pin D-type connector on the back panel. Use the RCA-type 
phono jack to connect a video monitor or the DB-15 connector 
lor an external video modulator; use the 15-pin connector to 
attach video expansion hardware (section 1 1 .9.5). 

Either of the two text modes can display all 96 ASCII 
characters; uppercase and lowercase letters, numbers, and 
symbols. 



5.1 Specifications 



fm 



J 



5,2 Text Modes 



MouseText: see section 5.2.2. 



The text characters displayed include the uppercase and 
lowercase letters, the ten digits, punctuation marks, and special 
characters. Each character is displayed m an area of the screen 
that is seven dots wide by eight dots high. The characters are 
formed by a dot matrix five dots wide (with a tew exceptions, 
such as underscore), teaving two blank columns of dots 
between characters in a row. Except for lowercase letters with 
descenders^ the characters are only seven dots high, leaving 
one blank line of dots between rows of characters, 

The normal display has white (or other monochronne color) dots 
on a dark background. Characters can also be displayed as 
black dots on a white background; this is calted inverse format. 



5.2. 1 Text Character Sets 

The Apple lie can display either of two text character sets: the 
primary set and an alternate set (Table 5-3), The forms of the 
characters in the two sets are actually the same, but the 
available display formats are different. The display formats are 

• normal, with white dots on a black screen 

• inverse, with black dots on a white screen 

• flashing, alternating between normal and inverse. 

With the primary character set, the Apple lie can display 
uppercase characters in all three formats: normal, inverse, and 
flashing. Lowercase letters can only be displayed In normal 
format. The primary character set Is compatible with most 
software written for the Apple II and II P5us, which can display 
text in flashing format but don't have lowercase characters. 

The alternate character set sacrifices the flashing format for a 
complete inverse format. With the alternate character set, the 
Apple lie can display uppercase letters^ lowercase letters, 
numbers, and special characters in either norma! format or 
inverse format. It can also display MouseText. 

You select the character set by means of the alternate-text soft 
switch, described in section 5.6, Table 5-3 shows the character 
codes In decimal and hexadecimal for the Apple He primary and 
alternate character sets in normal, inverse, and flashing formats. 
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To idenlify particular diaractsrs 
and vaEues, ref«r to Tabte 4-2. 
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Each character on the screen is stored as one byte of display 
data. The low-order stx bits make up the ASCII code of the 
character being displayed. The remaining two (high-order) bits 
select format and the group within ASCII (section 3,3.6). 



Table 5-3. 


We Dispt&y Character Sets 






Primary Character Set 
Hex Valitas Chareder Type Format 


Altemaie Character Set 
Character Type Format 


$00-$ IF 


Uppercase letters 


Inverse 


Uppercase letters 


Inverse 


S20-$3F 


Special characters 


in^/erse 


Special characters 


Inverse 


?40-S5F 


Uppercase letters 


Flashing 


MouseText 
(section 5.2.2) 




$60-57F 


Special characters 


Flashing 


Lowercase letters 


Inverse 


$80t9F 


Uppercase leners 


Normal 


Uppercase letters 


Normal 


SAO-SBF 


Special characters 


Normal 


Special characters 


Normal 


tCO-$DF 


Uppercase letters 


Normal 


Uppercase letters 


Normal 


lEO-SFF 


Lowercase letters 


Normal 


Lowercase letters 


Normal 



5.2.2 MouseText 

The character-generator ROM can display 32 graphics 
characters called MouseTestt in place of the inverse uppercase 
series from $40 through $5F. These graphics are especially 
convenient to use with a mouse, since they can be generated 
by character codes instead of groups of high-resoiution byte 
values, and they can be moved around quickly. To use 
MouseText characters, do the following: 

1. Turn on the enhanced video firmware: issue PR#3 or 
ESC 8 or ESC 4. 

2. Set inverse mode: use the INVERSE command or put $3F in 
location S32. or print CONTROL-O. 

3. Turn on the MouseText feature: PRINT CHR*C27); or 
pass $1B to COUT in the accumulator. 

4. Print the uppercase letter (or other ASCII character in the 
range S40-$5F: @ [ \ | " or _ ) that corresponds to the 
MouseText character you want, using C0UT1. 
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5. Turn off the MouseText feature: PRINT CHR*C24>; or 
pass $18 to C0UT1 in the accumulator, 

6. Set normal mode: use the NORMAL command or put $FF in 
location S32, or print a CONTROL-N. 

Here is a sample Applesoft program that prints all the 

MouseText characters; 



K 



ii^ 



10 D*^CHR$C4> 

20 PRINT PRINT D*;"Pff*3" 

30 INVERSE 

40 PRINT 

CHR*(27>;"&ABCDEFGHIJKLnK0P0RSTUVWXYZ[\]"_"; 

SO PRINT CHR*C24>; 

SO NORMAL 

Simulated MouseText characters and their corresponding ASCII 
characters are shown in Figure 5-1 . 

Figure S-1, MouseText Characters 

@A8CDE FG 
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M 
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P O R 



X Y 



I ♦ z 
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5.2.S 40-Coiumn Versus 80-Column Text 

The Apple lie has two modes of text display: 40-column and 
ao-column. The number of dots in each character does not 
change, but the characters in BO-coIumn mode are only half as 
wide as the characters in 40-column mode Compare the two 
displays in Figure 5-2. On an ordinary color or black-and-white 
television set, the narrow characters in the 80-column display 
bluf together; you must use the 40-coluimn mode to display text 
on a television set. 



^ 
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Figure S-S. 40-Column and 80-Cotumn Text Display 
{With AitefnatG Chatact&t Sst) 



ti3 REM APPLESOFT CHARACTER OEMO 

%% PRIKt' : PRINT "Applesoft 'Ch^r' 

! PRIMT ^ PRINT "Which characte 
r set"-" 
5@ PRINT ■ IKPUT "Prir-iary ^. P := or 

Alternats (ft> ■^''.h* 
t^8 IF LEH (R$) < 1 THEN 59 
1^5 LET Af = . LEFTf <^^.. 1 J- 
-g IF rt* ^ ^.f-.;THEN POKE 4316b. 

ru IF A$ = "fl" "^W^H POKE 49ib7. 
S 

rO PRIMT ■■ PRINT V..prantin? ^h 

e fa^H'^ line^ first-^' 
" '""'i PRIM! '■' in NORHwL. then 

RSE ..then FLASH ^ " ^ PRI:-- 
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Figure 5-3 illustrates the methods of switching text display 
modes, and the characteristics of each. 



Figure S-3. Text Mode Characteristics snd SW'tcfling 
Power On 



[esc] [control] -to] 
Resets full 
40-column Window 



Cursor: checkerbnard 
nput Hook: KEVIN 
Output Hook; CO UT1 
Window: 40 columns, 

24 lines 
Character Set: primary 




CLFSor: square box 
lnpjtHook'C3KEYlN 
Output Hook: C3GOUT1 
Window: 40 columns, 

2i lines 
Character Set: alternate 



Cursor: narrow boJ? 
Input Hook: C3KEVIN 
Output Hook: C3C0UT1 
Window; 30 col uiTinis, 

24 lines 
Character S&t: alternate 
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5,3 Graphics Modes 



The Apple Mc can produce video graphics in any of three ^ 
different modes. Each graphics mode treats the screen as a 

rectangular array of spots. Normally, your programs will use y^^ 

tlie features of some high-level language to draw graphics "^ 

dots, lines, and shapes in these arrays; this section describes ^^^ 

the way the resulting graphics data are stored in the Apple lie's llj 

memory, "* 

' ^ i j^ 

5.3. f Low-Resolution Graphics -^ 

In the low -resolution graphics mode, the Apple lie displays an J| 

array of 48 rows by 40 columns of colored blocks. Each block |I^ 

can be any one of sixteen colors, including black and white. On *~ 

a black-and-white monitor or television set, these colors appear _^ 

as black, white, and two shades of gray. There are no blank |^ 

dots between blocks; adjacent blocks of the same color merge *" 

to make a larger shape. _ ^ 

Data for the low-resolution graphics display is stored in the s^ 

same part of memory as the data for the 40-column text 

display. Each byte contains data for two low-resolution graphics ^^ 

blocks. The two blocks are displayed one atop the other in a ^ 

display space the same size as a 40-column text character, 

seven dots wide by eight dots high ^ 

Half a byte—four bits, or one nibble — is assigned to each 

graphics block. Each nibble can have a value from to 15. and ^^^ 

this value determines which one of sixteen colors appears on ^^ 

the screen. The colors and their corresponding nibble values " 

are shown in Table 5-4. In each byte^ the low-order nibble sets _^ 

the color for the top block of the pair, and the high-order nibble iL^. 

sets the cotor for the bottom block. Thus, a byte containing the *" 

hexadecimal value $D8 produces a brown block atop a yellow ^^ 

block on the screen, K-i 
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C-olors may vary, depending upon 
the controte on the monitor or 
television set. 



TatH« S-4. Low-Pesotutton Grapf^ics Cotors 



Nibble Value 




nibble Value 




Decimal 


Hex 


Color 


Decimal 


Hex 


Color 





$0 


Black 


S 


S8 


Brown 


1 


SI 


Magenta 


9 


S9 


Orange 


2 


S2 


Dark Blue 


10 


SA 


Gray 2 


3 


S3 


Purple 


11 


IB 


Pink 


A 


$4 


Dark Green 


12 


»C 


Light Green 


5 


S5 


Gray 1 


13 


$D 


Yeltow 


6 


S6 


Medium Blue 


14 


$E 


Aquam&rine 


7 


S7 


Light Blue 


15 


$F 


White 



As explained in section 5.5, the text display and the 
low-resoiution grapliics display use the same area in memory. 
Most programs that generate text and graphics clear this part 
of memory when they change display modes, but it is possible 
to store data as text and display it as graphics, or vice versa, 
A!l you have to do is change the mode switch, described in 
section 5.6, without changing the display data. This usually 
produces meaningless jumbles on the display, but some 
programs have used this technique to good advantage for 
producing complex low-resolution graphics displays quickty. 

5,3,2 High-Resolution Graphics 

In the high-resolution graphics mode, the Apple lie displays an 
array of colored dots in 192 rows and 280 columns. The colors 
available are black, white, purple, green, orange, and blue, 
although the colors of the individual dots are limited, as 
described below. Adjacent dots of the same color merge to 
form a larger colored area. 

Data for the high -resolution graphics displays is stored in 
either of two B192-byte areas in memory. These areas are 
called high-resolution Page 1 and Page 2; think of them as 
buffers where you can put data to be displayed. Normally, your 
programs will use the features of some high-level language to 
draw graphics dots, lines, and shapes to display; this section 
describes the way the resulting graphics data are stored in the 
Apple lie's memory. 

The Apple lie high-resolution graphics display is bit-mapped: 
each dot on the screen corresponds to a bit in the Apple lie's 
memory. The seven low-order bits of each display byte control 

5.3 Graphics Modes \W 
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a row of seven adjacent dots on the screen, and forty adjacent 

bytes in memory control a row of 280 (7 times 40) dots. The ^^ 

least significant bit of each byte is displayed as tfre leftmost dot A^ 

in a row of sevens followed by the second-least significant bit, 

and so on, as shown in Figure 5-4. The eighth bit (the most 

significant) of each byte is not displayed; it selects one of two 

color sets, as described below. 

On a black-and-white monitor, there is a simple correspondence 
between bfts in memory and dots on the screen. A dot is white 
if the bit controUing it is on (1), and the dot is black if the bit is 
off (0). On a black-and-white television set, pairs of dots blur 
together; alternating black and white dots merge to a 
continuous grey. 

On an NTSC color monitor or a coior television set, a dot 

whose controlling bit is off (0) is black. It the bit is on. the dot 

will be white or a color, depending on its position, the dots on 

either side, and the setting of the high-order bit of the byte. Call 5^ 

the left-most column of dots column zero, and assume (for the 

moment) that the high-order bits of all the data bytes are off (0). --^ 

If the bits that control them are on, dots in even-numbered Ir^ 

columns, 0, 2, 4, and so forth, are purple, and dots in 

odd-numbered columns are green — but only ff the dots on ^-^ 

either side are black. If two adjacent dots are both on. they are S^^ 

both white. 

You select the other two colors, blue and orange, by turning the m^ 
high-order bit (bit 7) of a data byte on (1). The colored dots ^ 

controlted by a byte with the high-order bit on are either blue or ^^ 

orange: the dots in even-numbered columns are blue, and the j|^ 

dots in odd-numbered columns are orange — again, only if the 
dots on either side are black Within each horizontal line of _, 

seven dots controlled by a single byte, you can have black. n^ 

white, and one pair of colors. To change the color of any dot to ~ 
one of the other pair of colors, you must change the high-order 
bit of its byte, wnich affects the colors of all seven dots 
controlled by the byte. 
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Colors may vary, depending on the 
adjustment of the monitor or 
television set. 



For more detaifs about the way the 
Appte lie prodjces color on a TV 
set. see Chapter 11. For a table 0) 
reversed bit patterns, refer to 
Appendix H. For intormation about 
the way NTSC color television 
works, see the magazine articles 
listed in the Bibliography. 



In other words, high-resolution graphics displayed on a color 
monitor or television set are made up of coJored dots, according 
to the foliowing rules: 

• Dots in even columns can be black, purple, or blue. 

• Dots in odd columns can be black, green, or orange, 

• If adjacent dots in a row are both on, they are both white. 

• The colors in each row of seven dots controlled by a single 
byte are either ipurple and green, or blue and orange, 
depending on whether the high-order bit is off (0) or on (1). 

These rules are summahzed in Table 5-5. The blacks and 
whites are numbered to remind you that the high-order bit is 
different 



rsi&fe *-5. High-R^soiution Graphics Colors 
Btt» 0-6 Bit 7 Off 

Adiacent columns off Black 1 

Even columns en Purple 

Odd columns on Green 

Adjacent columns on White 1 



Bit 7 On 

Black 2 
Blue 

Orange 
White 2 



The peculiar behavior of the high^resolution colors reflects the 
way NTSC coJor tetevision works. The dots that make up the 
Apple lie video signal are spaced to coincide with the frequency 
of the color subcarrier used in the NTSC system. Alternating on 
and off dots at this spacing cause a color monitor or TV set to 
produce color, but two or more on dots together do not. 



5.3 Graphics Modes 



FfguTB 5-A, HiQfj RssoioVon Display Bits 
Bits In Data Byte 








M- 



u^ 



D 


1 


2 


3 


4 1 5 


6 



Dots on Graphics Screen 



5,3.3 Dcub/e-High-Resotution Graphics 

Double-high-resoliition graphics is a bit-mapping of the 
low-order seven bits of the bytes in the two high-resolution 
graphics pages. The bytes in the main-memory and 
auxiliary-memory pages are interleaved in exactly the same 
manner as the characters in BO-column text: of each pair of 
identicai addresses, the auxiiiary-memory byte is dispiayed first. 
and the main-memory byte is dispiayed second. Hori^ontai 
resoiution is 560 dots when dispiayed on a monochrome 
monitor. 

Uniike high-resolution color (section 53.2), 
doubie-high-resolution color has no restrictions on which colors 
can be adjacent. Color is determined by any four adjacent dots 
along a iine. Think of a l-dot-vs^ide window moving across the 
screen: at any given time, the color displayed will correspond to 
the four-bit value from Table 5-6 that corresponds to the 
window's position (Figure 5-9), Effective horizontal resolution 
with color is 140 (560 divided by four). 

To use the table, divide the column number by 4, and use the 
remainder to find the correct column: abO is a byte residing in 
auxiliary memory corresponding to a remainder of 
{byte 0, 4, B. and so on), mbl is a byte residing in main memory 
corresponding to a remainder of 1 (byte 1,2, 9, and so on), and 
similarly for ab2 and mt>3. 
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Table S-6. DoublB-High-RosotuHon 


Graphics Colors 






m- 1 

1 - 




Color 


abO 


mbl 


ab2 


mb3 


Repeated Qrt 
Pattern 


Cqlgrs may vary, depending upon 
the cantrals on the monitor or 
teleu'ision set. 


Black 

Magenta 


$00 
$08 


SOO 

£11 


$00 
$22 


son 

S44 


0000 
0001 


L 




Brown 


$44 


SOB 


$11 


S22 


D010 


■-UI 




Orange 


$4C 


SI 9 


$33 


$66 


0011 


l: 




DarJ^ Green 


$22 


$44 


SOB 


$11 


0100 




Gray 1 


$2A 


ES5 


$2^ 


S455 


0101 


l: 




Green 


$66 


S4C 


$19 


$33 


0110 




Yellow 


$6E 


S5D 


$3B 


$77 


0111 


r 




Dark Blue 


$11 


£22 


$44 


$06 


1000 




Purple 


$19 


$33 


$66 


$4C 


1001 


1^ 




Gray 2 


S55 


S2A 


$55 


$2A 


1010 


L 




Ppnk 


$5D 


£3B 


$77 


$6£ 


1011 


■ ^ 




Medium Blue 


S33 


$66 


$4C 


$19 


1100 


L 




Light BluB 


S3B 


577 


$6E 


$5D 


1101 


^^ 




Aqua 


S77 


$6E 


$50 


S5B 


1110 


u 




White 


S7P 


$7F 


$7F 


S7F 


1111 


g' ^ 




H| UdLlM^I bit 














Blls In Data Byle 
UHmory 7flS » 3> 2 1 qI? S 5 i 3 2 1 Cl|7e5 * 32 1 0\7GiA3?. ■ □ 



^ 



^ 



:t 



CHfOtav i31£}012 30123.01 23|ciE3|d i;3|d1£3 
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5.4 Mixed-Mode Displays _^^ 

Any of the graphics displays can have four lines of text, either i 

40-column or 80-column, at the bottom of the screen. Grapiiics _^ 

displays with text at the bottom are called mixed-mode \ j- ^ 

displays. To use them, the TEXT switch must be off (read ^ 

$C050) and the MIXED switch on {read SC053}, ^^ 

Note: You cannot display 40-column text with ** 

double-high-resolution graphics. _^ 

To determine what appears where in mixed-mode displays, "" 

refer to the upper five-sixths (down to the heavy horizontal line) ^^ 

in the appropriate graphics display [Figures 5-7 to 5-9); then |i ^ 

refer to the bottom sixth of th^ appropriate text display "" 
(Figure 5-5 or 5-6). ^ 



5.5 Display Pages 



The Apple lie generates its video displays using data stored in 
specific areas in memory. These areas, called display pages, 
serve as buffers where your programs can put data to be 
displayed. Each byte in a display buffer controls an object at a 
certain location on the display: a character, a colored block, or 
a group of adjacent dots. 

The 40 -column-text and low-resolution-graphics modes use two 
display pages of 1024 bytes each. These are called Text Page 1 
and Text Page 2. and they are located at $400-$7FF and 
$800-SBFF in main memory. Normally, only Page 1 is used, but 
you can put text or graphics data into Page 2 and switch 
displays instantly. Either page can be displayed as 40-column 
text, low- re solution graphics, or mixed-mode (four rows of text 
at the bottom of a graphics display). 

The 8Q"Coiumn text mode displays twice as much data as the 
40-column mode— 192D bytes— but it cannot switch pages 
when the enhanced video firmware is active. The 80 column 
text display uses a combination page made up of Text Page 1 
in main memory plus another page in auxiliary memory. This 
additional memory is nof the same as Text Page 2— in fact, it is 
Text Page IX, and it occupies the same address space as Text 
Page 1 (see Figure 2-1 1). The built-in firmware I/O routines 



f^ 



^ 
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described in Chapter 3 take care of this extra addressing 
automatically; tinat is one reason to use these routines for ail 
normal text output. 

Note: The buiil-in video firmware always displays Page 1 text. 
You cannot write text to Page 2 uniess you do it yourself. 

The high-resolution graphics mode also has two display pages, 
but each page is 8192 bytes long. In the 40-column text and 
low-resolution graphics modes each byte controls a display area 
seven dots wide by eight dots high, in high-resolution graphics 
mode each byte controis an area seven dots wide by one dot 
high. Thus, a high-resolution display requires eight times as 
much data storage, as shown in Table 5-7. 

The double-high-resolution graphics mode interleaves the two 
high-resolution Pages (1 and IX) in exactly the same way as 
eO-column text mode interleaves the text pages: column and 
all subsequent even-numbered columns come from the auxiliary 
page; column 1 and all subsequent odd-numbered columns 
come from the main page. 

Table 5-7. Video Dispfay Page Locations. (1) This is not sopportsd by firmware: 
for instructions on how to switcti pages, refer to secUorj 5-6. (2} See 
sec^on 5.3.3. 



Display Mode 


Display 
Page 


Lowest Address 


Highest 


Address 


40-colunin texi, 

low-resoluiion 

graphics 


1 
2(1) 


SBOO 


1024 
2049 


$7FF 
SBFF 


2D47 

3D71 


SO-column l&M 


1 

2^) 


S4O0 
SfiOO 


1024 
2048 


$7FF 
$BFF 


2047 

3071 


high- resolution 

graphics 


1 
2 


S2D0D 
S4000 


9192 
163&4 


$3FFF 
SSFFF 


16383 
24575 


double-'liigh- 

resolution 

graphics 


1(2) 
2(2) 


S20D0 
£40Q0 


8192 

163B4 


S3FFF 
$&FFF 


16383 
16383 
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5,6 Display Mode Switching I 

Table 5-B shows the reserved locations for the soft switches ^ "i 

that control the different display modes. The left column o1 the J 

table, labelled Action, indicates what to do to activate or read a T^ 
switch setting; R means read the location, W means write '^ 

anything to the location, RfW means read or write, and 
R7 means read the location and then check bit 7. 

Table 5-9 lists the display modes that the firmware can set up 
automatically. In the 40-column modes, the contents of the 
standard I/O hooks KSW and CSW (Chapter 3) determine 
whether the enhanced video firmware features are available or 
not. The firmware also takes care of setting or clearing 
ALTCHAR. 

Tabie 5-10 lists other display modes available but not supported 
by firmware. For modes that display Page 2 with the 80COL 
switch on, your program may have to turn SOSTORE off after 
the firmware has turned it on. 

Double-low-resolution shows on the display screen when HIRES 
is off and both SOCOL and DHIRES are on. It is the 
iow-re solution graphics equivalent of 80-column text, and it 
uses the same map (Figure 5-6). 

The lOUDIS switch must be on for locations $C05E and $C05F 
to change DHIRES- The firmware in fact leaves it on— and your 
program should, too — unless it wants to use iocations $C05E 
and $C05F to change mouse values (Chapter 9). 



b- 



»- 
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rad/? S-ff. DfSptay Soft Switch&s. fl) Jf^e firmware normaify feavas tOUOfS on. 
See s!so note 2. (S) Heading or wtmg any aaaress in me range $C07Q$C07F 
also triggers the pacf<f!e timer ancf resets VBUNT (Chapter 9). 

Note 



Action 


Hex 


Name 


Function 


W 


SCODE 


ALTCHAR 


Off: diisptay text using primary 
character set 


w 


SCODF 


ALTCHAR 


On: display text using alternate 
character set 


R7 


SC01E 


RDALTCHAR 


Read ALTCHAR switch (1 on) 


W 


scooc 


80COL 


Off: ctisplay 4CI coiomns 


w 


SCODD 


BOCOL 


On: display 30 columns 


R7 


SC01F 


ROeOCOL 


React BOCOL switch (1 = on) 


W 


scooo 


80STORE 


Off: cause PAGE2 on to select 

auxtliary RAM 


w 


SCO01 


BOSTORE 


On; aliow PAeE2 to swUcti main 
RAM areas 


R7 


SCOlfi 


RDeOSTORE 


Read SOSTOR^ switch (1 = onj 


R/W 


SC054 


PAGE2 


Off: select page 1 


RiW 


SCOBS 


PAGE2 


On: select page IX (SOSTORE 
on} Of 2 


n? 


SCQ1C 


RDPAGE2 


Read PAGE2 switcii (1 = on) 


R/W 


SC050 


TEXT 


Off: dispfay graphics or (If 
MIXED on) mixed 


R/W 


SC051 


TEXT 


On; display texi 


R7 


SC01A 


RDTEXT 


Read TEXT switct> [1 = ont 


R/W 


ECO 53 


MIXED 


Off: display only text or only 
graphics 


R/W 


SCQ54 


MIXED 


On: [if TEXT off) display text and 
graphics 


R7 


£C01B 


RDMIXED 


Head MIXED switch (1 = on) 


R/W 


SC057 


HIRES 


Off: (if TEXT off) dispfay 
low-reso9U:tion grapliics 



R/W SC0S8 HIRES 



H7 



SCOTD RDHIRES 



On: (if TEXT off) display 
high-resolution or (if DHIRES an) 
doubie-lnigh^resolution graphics 

Read HIRES switch (1 ■= on) 
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Tabte 5-8 — Continued. OiSQisy Soft Switches 



Action 
W 

W 



HSK 
$C07E 



Name 

lOUDSS 



SC07F lOUDIS 



R7 


SC07E 


RDIOUDIS 


R/WV 


$C05E 


DHIRES 


RfW 


SC05F 


DHIRES 


R7 


SC07F 


RDDH)RES 



Function Note 

On; disable lOU access for {^} 

addresses SC0b6 \o 5G05F: 
snaDie access to DHIflEE switcti 

Offr enable lOU access for (1) 

addresses SCD58 lo EC05F; 
disable access to DHIRES 
switch 

Read iOUDIS switch (1 = off) (2) 



On: [if IOUDIS on) turn on 
dojble-liigri resolution 

Off: (if lOUDIS on) turn off 

double-hig h-re solution 

Read DHIOES switch (1 = on) {2] 



d 

J 



^ 
^ 
^ 
^ 
^ 
^ 
^ 
^ 
^ 
^ 
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Tabfe S-9, Disptay Modes Supporlecf by Firmware (fnciucffng Appiesoft). (t) BOSTOftE is set by ths ffrmuvsre when 

BOCOL is turned on. 



Display 




Switches 














Col/Rea 


Typ« Page fi[>COL 


BDSTORE 


PtkGEl 


TEXT 


MIXED 


HlflES 


DHinES 


AO-column 


text 1 


Off 




Off 


on 


off 


oil 


otf 


aO-column 


text 1 


on 


0) 




on 








low-res 


graphics t 


off 




off 


off 


off 


off 


off 


40/IOW 


mixed 1 


off 




off 


oH 


on 


ofl 




ao/iow 


mixed 1 


on 


(1) 


off 


off 


on 


on 


of! 


hi-res 


graphics 1 


oH 




oft 


off 


off 


on 




tii-res 


graphics 2 


off 




on 


off 


off 


on 




40/high 


miKed 1 


off 




Off 


off 


on 


on 




80/hJgh 


mixed 1 


on 


(1) 


off 


off 


on 


on 


off 



Tffble 5-10. Other Dispiay Modes. (1) 80STORE is set by the firmware when 80COL is turned on^ arjcf must be turned off 
to use the second SO-coftirnn or doublg-tjigh-rssoiution page. This means ffjat you cannot use firmware routines such as 
COUT when dispfaying Page 2 modss not supported by firmware. 



Display 






Switches 














Col/Res 


Type 


Page 


BOCOL 


aOSTORE 


PAGES 


TEXT 


MIXED 


HIRES 


DH 


40-column 


text 


2 


off 




on 


on 








BO^columr 


2 


or 


off 


on 


on 










low-res 


graphics 


2 


off 




on 


off 


off 


off 




40/low 


miKed 


2 


off 




on 


off 


on 


oft 




30/low 


mixed 


2 


on 


off 


on 


off 


on 


off 


off 


dbi-tow 


graphics 


1 


on 


(1) 


off 


off 


off 


Off 


on 


dbUlow 


graphics 


2 


on 


Dlt 


on 


off 


off 


off 


on 


80/dbl-low 


mixed 


1 


on 


ni 


oH 


off 


on 


off 


00 


SO^dbl-low 


mixed 


2 


on 


off 


on 


off 


on 


off 


or 


40/high 


mixed 


2 


off 




on 


o(f 


on 


on 




ao/high 


mixed 


2 


on 


oft 


on 


off 


on 


on 


off 


dbl-mgh 


graphics 


1 


on 


M) 


Off 


off 


Off 


on 


on 


dbl-high 


graphics 


2 


on 


off 


on 


off 


off 


on 


on 


eO/dbl-high 


mixed 


1 


on 


(1) 


off 


off 


on 


on 


on 


eo/dbl-high 


mixed 


2 


on 


off 


on 


off 


on 


□r 


□n 
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For example, to switch to mixed 80-column and 
double-higb-resolution display Page 1, you can use these 

instructions: 



STft ICOOD Turn on 80COL: firmware then turns on 
80STORE 

LDA tCOB-* Turn off PAGE2; you could also have 

done a STA 

STA *COBO Turn off TEXT, that is, turn on graphics 

mode 

STA $C053 Turn on MIXED; it works now that TEXT 

is off 



IH- 



STA tC057 



Turn on HIRES; it works now that TEXT is 
off 



STA «C07E Make Sure lOUDIS is on so you can 

access DHIRES 

LDA «C05E Turn on DHIRES; it works now that 



5. 7 Display Page Maps 



You shoutd never have to store directly into disptay memory, 
fviost high-ievei ianguages enable you to write statements that 
control the text and graphics displays. Similarly, if you are 
programming in assembly language, you should be able to use 
the dispiay features of the built-in I/O firmware. 

Mk Warning 

Never caff any firmware with 80COL on or with SOSTORE and 
PAGE2 both on. If you do. the firmware wiii not function 
properly. As a generaf rule, always leave PAGE2 off. 
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For more detB^Es about V\& way 
displavs are generated, see 
Chapter 11. 



The display memory maps are shown in Figures 5-5 
through 5-9- All the different display modes use the same basic 
addressing scheme: characters or graphics bytes are stored as 
rows of 40 contiguous bytes, but the rows themselves are not 
stored at locations corresponding to their locations on the 
display, instead, the display address Is transformed so that 
three rows that are eight rows apart on the display are grouped 
together and stored in the first 120 locations of each block of 
128 bytes (SSO hexadecimal). For a full description of the way 
the Apple He handles its display memory, refer to 
section 11.9 2, 

The high-resolution graphics display is stored in much the same 
way as text, but there are eight times as many bytes to store. 
because eight rows of dots occupy the same space on the 
display as one row of characters. The subset consisting of all 
the first rows from the groups of eight is stored In the first 
1024 bytes of the high-resolution display page. The subset 
consisting of ail the second rows from the groups of eight is 
stored in the second 1024 bytes, and so on for a total of 
8 times 1024, or 8192 bytes. In other words, each block of 
1024 bytes in the high-resolution display page contains one row 
of dots out of every group of eight rows. The individual rows 
are stored in sets of three forty-byte rows, the same way as the 
text display. 

The display maps show addresses only for each Page 1. To 
obtain addresses for text or low-resolution graphics Page 2, 
add 1024 ($400); to obtain addresses for high-resolution 
Page 2. add 8192 (S2000). 

The 80-coiumn display works a little differently. Half of the data 
is stored in the normal text Page 1 memory, and the other half 
is stored in the auxiliary memory text Page 1. The display 
circuitry fetches bytes from these two memory areas 
simultaneously and displays them sequentially; first the byte 
from the auxiliary memory, then the byte from the main 
memory. The main memory stores the characters in the odd 
columns of the display, and the auxiliary memory stores the 
characters in the even columns (starting with column on the 
left). 

To store display data in auxiliary memory, first turn on the 
80STORE soft switch by writing to location $C0D1 . With 
80STORE on, the page-select switch PAGE2 selects between 
the portion of the 80-column display stored in Page 1 of main 
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memory and the portion stored in the auxiliary memory. To 
select auxiliary memory, turn the PAGE2 soft switch on by 
reading or writing at location SC0S5, 

The double-highresolution graphics display stores informatfon 
in the same way as high resalutton graphics, except there is an 
auxiliary memory location as well as a main memory location 
corresponding to each address. The two sets of display 
information are interleaved in a manner similar to the 
interleaving of two 40-column displays to create an 80-column 
text display (Figure 5 9). 






Figure 5-5. Map of 40-Cotumn Text Disptsy 
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Figure 5-6. Map of 80-Column Text Display 



Row 

$400 1024 

1 $480 1152 

2 $500 1£&0 

3 $580 14 OS 

4 S600 1536 

5 $680 lee^ 

6 $700 1792 

7 $780 1920 
B 3428 1064 
9 S4A8 1192 

10 $5^a 1320 

11 $5Aa 1448 

12 $628 1576 

13 $6Ae 1704 

14 $739 1832 

15 S7Aa 1960 
ie $450 1104 
17 $4D0 1232 

16 $550 1360 
IS $5D0 1488 



20 £650 1616 

21 $600 1744 

22 $750 1672 

23 $7D0 2000 



Main Memory 



$00 $01 $02 $D3 $04 $05 
12 3 4 5 



$20 $21 $22 $23 $24 $25 $28 $27 
32 33 34 35 36 37 36 39 



$0Q sot $02 sas $04 $0& 

12 3 4 5 
I Auxiliafy Memory |^~ 



$07/ 

7 
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32 33 34 35 33 37 3fl 3S 
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Figure S-7. Map of Low-Resotution Graphics Dispfay 



Row 

, 

1 ' 

2 
3 
4 

5 
6 

7 
6 

a 

10 

11 

12 
13 

14 
15 
1fi 
17 

ie 
le 

20 
21 
22 
23 
24 
25 
26 
27 
2fl 
26 
30 
31 
32 
33 
34 
35 
3« 
37 
3£ 
39 



$400 



S5C0 
$580 
$fiQO 

S6sa 

$700 
3780 

$4ae 



$523 
$&A6 
$628 
$6A8 
5728 
$7 A* 

$400 

S5&Q 
£5 DO 



O '^ fJ rt 

O D O O' 
W 4^ «^ V» 






0'~CMej-*"ni*f^^oiO'-t^ rt^ijvtBi-.eco) 



T--I-1— T-l— 1-1— T-I-t-ii-1-CNCVCMftJt^CMC>JfJ 

cwCMCMWcycywfdt>ic\iP3rtrtrtrtOf^p?«Pi 



1024 
1152 
1260 
1A08 

1536 

1792 

1920 
1061 

1192 

i:j20 
144Q 
1576 

i7a4 

1B3.2 
196C 
1104 

1232 
13B0 
14eS 



40 
41 
4? 
43 
44 
45 

J* , S7D0 aooo 



SGSO 1616 
$6D0 1744 
$750 1072 



_ , . ■ — — 



\~~~~~~~~ — — 'Z — — — — — Z.~~ — ~ — — — — — ^— — — — — ~ — — ^ 

' ' "^ ^ ^___ ^_ ^ ^ 

.^^^ — .^ ^^ . : : . . .^^^^_^ . ■ 

■ ' 

^_ ^_ ^— _^ . "— ^— ^— ^— '— ^ I ' ' •^— ^— ^ ^— — = ' ' 

l^—~~~~ — —— — —~——~'^ 

.^ . — ..^__^^__, — . .^^^^^^ — , .=_^__ 

, . . :■ ■ ■■' — 

, , ^ ^ ^ ^ : , . . — ^ ^ ^ ^ T— ■ ■ ^ ^ ^ -^ 

H^ ^" —--^---zzz 



3 






m^ 



1121 



Chapter 5: Video Display Output 



1= 



L 

E 
l: 

l: 
l: 

r 



FfStifC S-8. Map of High-Resolution Graphics Dispiay 
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Figure S-9. Map of Doubfe-Higfi-Resoiution Graphics D/spfay 
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5,8 Monitor Firmware Support 



Table 5-9 summarizes the addresses and functions of the video 
display support routines the Monitor provides. E)<cep1 for 
COUT and C0UT1, which are explained in Chapter 3, these 
routines are described in the subsections that follow^ 

Tabitt 5- 1 1. Monitor Firmware Hoiftines 



Location 


Name 


Pesctiplion 


SFC9C 


CLREOL 


Clears to end of line from current 
cursor position 


5FC9E 


CLEOLZ 


■Clears to end of line using 
contents of Y register as cursor 

position 


SFC42 


CLREOP 


Clears to bottom of window 


SF832 


CLRSCR 


Clears tJie low resolution screen 


SFB36 


CLRTOP 


Clears top 40 lines of 
low-resolijlion screen 


$FDED 


COUT 


Calls output routine whose address 
is stored in CSW (r^ormally C0LH1, 
Cliapter 3) 


SFDFO 


C0UT1 


Displays a character on the screen 
{Chapter 3 J 


SFDaE 


GROUT 


Generates a carriage return 

character 


SFDSB 


CR0UT1 


Clears to end of line, then 
generates a carriage return 
character 


$Fei9 


HLINE 


Draws a horizontal line of blocks 


SFCsa 


HOME 


Clears the window and puts cursor 
in upper-left comer of virindow 
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Table S'1-f- 


-Contfnued. Monitor Fintiware Routines 




LD<:atJan 


Name 


Description 


d 


SF80D 


PLOT 


Plots a single low-resolution block 
on tlie screen 


J 


SF94A 

SFDDA 


PRBL2 

PR BYTE 


Sends 1 to 256 tjlank spaces lo 
the output device whose address is 
in CSW 

Prints a hsxadedmal byte 


fi3 


SFF2D 


PRERR 


Sends ERF? and CONTROL-G to 

the output device whose oLlpiit 
routine acldress is in CSW 


^ 


$FDE3 
$F941 


PRHEX 
PRTAX 


Prints 4 Dits as a hexadecimal 
numl>er 

Prints contents of A and X in 
hexadecimal' 


^ 


SFe71 


SCHM 


Reads color value of a 

low- resolution block on the screen 


g: 


$Fa64 


3ETC0L 


Sets the color for plotting in 
low-resolution 


^ 


SFC24 


VTAB2 


Sets cursor ^^erticai position 

(Setting CV at location S25 does 
not change vertical positon uniil a 
carriage return.) 


SFa2S 


VLiWE 


Draws a vertical lire of 
low'resolutfDfi blocks 


^ 









CLREOL 

CLBEOL clears a text line trom the cursor position to the right 
edge of the window. This routine destroys the contents of A 
and Y, 



CLEOLZ 



CLEOLZ Clears a text line to the right edge ot the window, 
starting at the location given by base address BASL indexed by 
the contents of the Y register. This routine destroys the 
contents of A and Y. 



CLREOP 

CLREOP clears the text window from the cursor position to the 
bottom of the window. This routine destroys the contents of A 
and Y. 
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CLRSCR 

CLRSCR clears the low-resolution graphics display to black. If 
you call this routine while the video display Is in text mode. It 
tiiis the screen with inverse-mode at-sign (@) characters. This 
routine destroys the contents of A and Y. 

CLRTOP 

CLRTOP is the same as CLRSCR. except that it dears only the 
top 40 rows of the low -resolution display. 

COUT 

COUT caiis the current character output subroutine 
(section 3.3,1). The character to be sent to the output device 
should be in the accumulator. COUT calls the subroutine 
whose address as storeC in CSW (locations $36 and $37), 
which is usually the standard character output C0UT1. 

court 

C0UT1 {section 3.3.2) displays the character In the 
accumulator on the display screen at the current cursor 
position and advances the cursor. It places the character using 
the setting of the inverse mask [location $32). It handles these 
control characters: carriage return, Jine feed, backspace, and 
bell. When it returns control to the calling program, ail registers 
are intact 

CROUT 

GROUT sends a carriage return to the current output device. 

cRoan 

CR0UT1 clears the screen from the current cursor position to 
the edge of the text window, then calls CROUT. 

HUNE 

HLINE draws a horizontal line of btocks of the color set by 
3ETG0L on the low-resolution graphics dfspiay. Cali HLINE 
with the vertical coordinate of the line in the accumulator, the 
leftmost horizontal coordinate in the Y register, and the 
rightmost horizontal coordinate in location $2C HLINE returns 
with A and Y scrambled and X intact. 
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HOME 

HOME dears the display and puts the cursor in the uppeNeft t-« 

corner of the screen. 



PLOT 



M« 



PLOT puts a single block of the color value set by SETCOL on _^ 

the low-re solution display screen. Call PLOT with the vertical Hm 
coordinate of the iine in the accumulator, and its horizontal 

position in the Y register, PLOT returns with the accumuiator _^^ 

scrambled, but X and Y intact. g&d 






PRBL2 

PRBL2 sends from 1 to 256 blanks to the standard output 
device. Upon entry, the X register should contain the number of 
blanks to senci. if X = $00, then PRBLANK will send 
256 bianks- 

PRBYTE 

PRBYTE sends the contents of the accumulator in hexadecimal 

to the current output device. The contents of the accumulator ^^ 

are scrambled ES* 



PRERR 

PRERR sends the word ERR, followed by a beli character, to 
the standard output device. On return, the accumulator is 
scrambled. 

PRHEX 

PRHEX prints the lower nibble of the byte in the accumulator 
as a single hexadecimal digit- On return, the contents of the 
accumuiator are scrambled. 

PRTAX 






PRTAX prints the contents of the A and X registers as a BH 
four-digit hexadecimal value. The accumulator contains the first 

byte printed, and the X register contains the second, On return, ^^ 

the contents of the accumulator are scrambled. ^ 
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SCRN 

SCRN returns the color value of a single block on Ihe 
low-resolution display. Call it with the vertical position of the 
block in the accumulator and the horizontal position in the 
Y register. The blocks color is returned in the accumulator. No 
other registers are changed. 

SETCOL 

SETCOL sets the color used for plotting In low-resolution 
graphics to the value passed in the acumulator. The colors and 
their values are listed In Table 5-4. 

VLINE draws a vertical line of blocks of the cofof set by 
SETCOL on the low-resofution dispiay. Call VLINE with the 
horizontal coordinate of the line in the Y register, the top 
vertical coordinate in the accumulator, and the bottom vertical 
coordinate in location $2D. VLINE returns with the accumulator 
scrambled. 
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Apple lie video firmware conforms to the 1/0 firmware protocol 
(section 3.4,2), However, it does not support windows other 
than the fuli 80-by-24 window in 80-column mode, and the fuil 
40-by-24 window in 40-coiurnn mode. The video (port 3) 
protocol table is shown in Table 5-12, 
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Tabte S-12. 


Port 3 Firmwffre Protocoi Tstfe 




e: 


Address 


Value 


Description 


^ 


SC30B 


SOI 


Generic signature E>yte of firmware 

cards 


m 
i 


SC30C 


£SS 


iSO-column card device signanjce 


J 


SC30D 


$jj 


$C3ii IS entry point of ioitialtzation 
routine (P)NIT). 


r 


$C30E 


Srr 


SC3rr Is entry point of read routine 
(PREAD). 


e 


SC3DF 


$ww 


JCSww is entry point of write 

routine (PWRiTE). 


i 

4 


5C310 


Sss 


$C3bs is entry point of (he status 

routine IPSTATUS). 








^ 
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I 
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PiNfT 

PINIT does the following: 

• Sets a full 80-column window 

• SetsSOSTORE ($C001) 

• Sets 80COL (SCOOD) 

• Switches on ALTCHAR (SCOOF) 

• Clears the screen: places cursor in upper-left corner 

• Displays the cursor. 

PBEAD 

PREAD resds a character from the keyboard and piaces it in 
the accumulator with the high bit cleared. It also puts a zero in 
the X register to indicate lORESULT - GOOD 

PWRiTE 

PWRITE should be called alter piacing a character in the 
accumulator with its high bit cleared. PWRITE does the 

following: 

• Turns the cursor off. 

• If the character in the accumulator is not a control character, 
turns the high bit on for normal display or off for inverse 
display, displays it at the current cursor position, and 
advances the cursor: if at the end of a iine. does carriage 
return but not line feed- See Ta&le 5-13. 

• Carries out control functions as shown m Table 5-10. 



I 
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TabfeS-tS. 


Pasca! Vfd&2 Control Functions 


CONTHOL- 


Hex 


E or © 


$05 


F orf 


S0& 


Gi or g 


E07 


H or h 


SOB 



J or j 



O or o 



or 



' or B 



$0A 



K ork 


SOB 


L or 1 


$oc 


M or m 


soo 


N or r 


SOE 



SOF 



V or tf 


$16 


Wor w 


$17 


V or y 


S19 


Z or 2 


SlA 


or \ 


$TC 



SIF 



Function performed 

Turns cursor on (enables cursor 
dispFay) 

Turns cursor otf (disables cjrsor 
display) 

Sounds bell (beeps) 

Moves cursor left one column. If 
cursor vi^es at beginning of tinCi 
moves jit 1o end of prewilous line 

Moves cursor down one row; 

scrolls It n&aded 

Clears to end o* screen 

Clears screen; moves cursor to 
jpper-left o( screen 

Moves cursor to column 

Displays subsequent characters ir> 
normal video. iCharacters already 
on display are unaffected.) 

Displays subsequeni characters In 
inverse video. (Characters already 
on display are unafrected-] 

Scrolls screen up one line: clears 
bottom line 

Scrolls screen down one line; 
clears top line 

Moves cursor to upper-lgft [home) 

position on screen 

Clears entire line that cursor fs on 

Moves cursor ngli( one column: it 
at end ol line, does CONTROL-M 

Clears to end of the Ime the cjrsor 
is or. including current cursor 
position; does not move cursor 

GOTOxy: Initiates a GOTOxy 
sequence: anterprets t'h-e next two 
characters as X-+-32 and y + 32, 
respectively 

It not at top of screen, moves 
cursor up one line 



U4 



fc- 
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When PWRITE has completed thfs. it 

• turns the cursor back on (If it was not intentionally turned 

off). 

• puts a zero in the X register (lORESULT = GOOD) and 
returns to the calling program. 

PSTATUS 

A program that calls PSTATUS must first put a request code tn 
the accumulator: eJther a (meaning 'Ready for output?^ or a 1 
(meaning "Is there any input?"). PSTATUS returns with the reply 
in the carry bit: {No] or 1 {Yes). If the request was not or 1, 
PSTATUS returns with a 3 in the X register 
(lORESULT - ILLEGAL OPERATION): otherwise, PSTATUS 
returns with a in the X register (lORESULT = GOOD). 
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The external disk drive connector 
is descfibed in septiion 11. tO, 






The Apple lie supports both rts built-in disk drive and an 
optional external drive; both drives use single-sided, 35-track. 
16-sector format. The disk I/O port characteristics are 

summarized in Table 6-1. 

The firmware resides in the $C600 address space. It supports 
the built-in drive as if it were slot 6 drive 1, and the external 
drive as if it were slot 6 drive 2. If disk startup is unsuccessful, 
the firmware shuts off the disk drive motor and displays the 
message. Check Di5k Drive on the display screen. 

Table €-1, Disk I/O Characteristics 



Port Number 


!/0 Port G Drive 1 (buill-in drive) 
I/O Port 6 Drive 2 (external drive) 


CommandB 


JN#e or PR #6 

CALL -151 (to get to the Monitor 




from BASIC), Itien [T) ( conthou KhI of 


Initial 

Characteristics 


Ah resets except tcommoLXRESETj 
with a valid reset vector eventually 
pass control to the built-in disK dfjye. 


Hardware Location 


Pe&cription 


$COEQ EF 


Reserved 


Monitor Firmware 
Routines 


None 


t/O Fiirfnware Entry 
Poiots 


SC600 (port S) 


Use or Screen Holes 


Port 6 main and auxiliary memory 



screen hoFes are reservedr 
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6. 1 Startup 



To restart the system, issue a PR^'G command from BASIC, 

(e) ( CONTROL K F] from Monitor command mode, or 
JMP tCBOO from a machine-language program. 



6.2 External Drive Startup 



The ProDOS operating system (but not the DOS or Pascal 
operating systems) supports Startup using the externai disk 
drive. This ProDOS feature maizes it possible to start the 
Apple lie with a diagnostic program in the event that the buiU-in 
drive does not work. 

To restart using the externa] drive, insert a ProDOS disk in the 
external drive, then invoke the Monitor {CALL -151) and issue 
(T) ( CONTROL y (p). 

Remember: External drive startup works with ProDOS-based 
programs, but not with Pascal 1.1 or 1.0, or with DOS. 



i 



A power on startup, an l"nl- ( comtrol>Creset} startup, or a 

CC0NTRQLKFIE5ETJ Startup that does not find a valid reset vector 

results in a cold start. The cold-start routine llrst sets a number 

of soft switches (see Chapter 2) and then passes control to the 

program entry point at $C600. This code turns on the internal 

drive motor, recalibrates the read/write head at track zero, then i^d 

reads sector zero from that track. The sector contents are ' 

loaded and decoded starting at address S800: then program 

control passes to $801. This loaded program varies depending 

on the operating system or application program on the disk. 
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If yoLi reed to change port 
charade ristfcs from a program, 
read section 7.6 for the methods to 
use. 



tf you cliange port 1 to a 
communication port, reler to Ihe 
descriptions in Chapter 8, and 
use 1 Instead of 2 fof ttie port 
number when required. 



Serial port 1 is the first of two serial I/O ports available on the 
Apple lie. It is intended primarify as an output port for RS-232 
devices, such as printers and plotters. It can be changed to a 
serial communication port (like port 2) using the System Utilities 

Disk. 

Warning 

Although the Apple tfc ser/at ports are similar to the Appfe ffe 
Super Serf at Card, there are many importarjt differences. Refer 
to Appendix F for a summary of tfiese differences. 

Table 7-1 summarizes the characteristics of this port if used as 
a printer/plotter port, and is a guide to the other information in 
this chapter. 

The serial port back pane] connectors are deschtjed in 
section 11,11. 
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Table 7- 1. Senaf Port 1 CharacteristiGs 

Part Number 

Commands 



Initial Characteristics 
Hardware Page Locations 
Monitor Firmware Routines 
I/O Fimiware Entry Points 
Use ol Scr€«n Holes 
Use of Other Pages 



Serial port i 

Keyboard command 
PR#1 

BASIC command 
PR#1 

Monitor command 

1 CONTROL'P (does not work 
if there Is an opetating system 
Jn RAM) 

All otner commands 
Tatole 7-2 

Tabie 7-3 

Table 7-4 

None 

Table 7-5 

Table 7-6 

None 



7- / Using Serial Port 1 



Refer to Table 7-5 for (he standard 
firmware entry points thet 
Pascal t.l aod 1-2 use. 



You can access the firmware from BASIC in the usual way— 
that is, by issuing CONTROL-D (if DOS or ProDOS is In RAM) 
and PR#1, Subsequent output is directed to the printer (or 
other device) connected to serial port 1 . 

To direct Pascal output to the printer, you can use either #B: 
or PRINTER: . 

Table 7-2 lists the commands you can use with serial port 1 , 
either from a program or from the l^eyboard. after you issue 
PR#1. Each command must be preceded by CONTROL-I (the 
command character). As soon as you issue the command 
character, the serial port firmware displays a flashing question 
mark cursor to indicate it is awaiting a command. 

You do not have to press rR^u^H) after commands. 

Note: The commands themselves are letter commands, not 
control characters. 
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Table 7-S. Printer Port Commarjds 

Comniand Description 

nnn 



nrB 



nt> 



Set new lire width of nnn (fram t through 255). This command 
must be followed by N (see belowj or by a carnage retjrri'. 

Set bajd rate to value corresponding to nn: 

im RalB nn Rate 

t 50 9 1BD0 

2 75 10 2400 

3 110f109.92) t1 3600 

4 135(134.58) 12 4800 

5 l&O 13 7200 

6 30a 14 9600 

7 600 15 19200 
a 1200 

Set data format to vaiLies corresponding to n: 



n Oati Bits Slop Bits 

a 1 

I 7 1 

a 6 1 

3 5 1 

4 8 2 

5 7 2 

6 e 2 

7 S 2 

) Echo printer output on me screen, 

K Disabie automatic lirift feed after carriage return. 

L Generate line teed after carriage return. 

nnnPJ Change line wpdtti to nnn (from 1 through 255: nnn is optional); do 

not Bcno printer output on the screen. Not&: ON does not disabie 
automatic generation of carriage return; to do so, use 2 command, 
put D directly in location S579 or use System Utilities Disk. 
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Table 7-£— Continued. PrmSer Port Commands 

Command Pescrfption 

nP Se( parity corresponding to n\ 



n 


Parity 





Mone 


1 


Odd 


2 


None 


a 


Even 


4 


None 


5 


MARK(1) 


S 


None 


7 


SPACE (0) 



R Reset port 1 (Table 7-3) and extt from serial port 1 firmware. 

S Send a 233 millisecond BREAK character (used with soma printers 

to synchronize witri serial ports). 

Z Zap (Ignore) furtlier command characters (uritiil [cgHTPptH beset] or 

PRi^l). Do not lormal output or insert carriage returns inlo output 
stream. 






g3 



The command character starts off as CONTROL-I for the printer 

port. You can change it to a different control character by I 

typrng the current control character followed immediately by the pS 

new contro!| character you want. This is useful if you want to be ^' 

able to send CONTBOL-I to the printer without firmware 

intervention. For example, to change the command character ^^ 

from CONTROL-I to CONTROL-V, simply press [control X T] ^^ 

(cqnthqlX T). (CONTROL-V and CONTROL-W are the ^ 

recommended substitute control characters.) To change the j"^ 

command character 5ack again, press ( control K V) ^ 

(controlK T). 

Do not use rcoNTHOD -TAl, -d], -Cc), -Ch), -(T), -Q. <m] cjr -(x): 
Apple lie firmware may intercept these control characters, 
causing unpredictable results. 



^ 
^ 
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The following are examples of valid commands and command 
sequences. 

Echo output to the display screen: 

f CONTROL > fT) CT] 

Set line width 72, disable line feed, and echo: 

CCONTROL> rn ® f CONTROL H D [TXlXE) 

Change control character to CONTROL-V: 

{ CONTROL K T) C CONTROL K V] CRETUAnI 

An example ot how you can send CONTROL-I as part of a 
character stream; 

( CONTROL K vl (command) (return] 



7.2 Characteristics at Startup 



After power-up, the printer firmware sets the configuration given 
in Table 7-3. These values are stored in the auxiliary-memory 
screen holes (Table 7-6). 

Tabl& 7-3. Initial Charactenstics of Printer Port 

9600 bajd 

Eighi data bits, no parity bits, two stop bits 

&0-Golumn line width; no echo to display screen 

Firmware supplies line feed after carnage return. 

Command character is set to CONTROL-I (see tiatow}. 

You can change some of these settings from the keyboard by 
typing PR#1, the command character^ and one of the 

commands listed in Table 7-2. Section 7.6 describes how port 
characteristics change as a result of various activities. 

Note: You can type more than one command on a Ime, but 
each must be preceded by the command character. 
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7,3 Hardware Page Locations 



ACIA stands for Asynchronous 
Communication Interface Adapter, 
a serial I/O chip. Note m 
Chapter i T that some of the bit 

assignmenis for thus port differ 
from tnoEfi lor port 2. 



Table 7-4 lists for serial port 1 the addresses and bit 
assignments of its hardware registers on page SCO. The 
registers are internal to a 6551 ACIA; their bit assignments are 
described in section 11.11. 

Tabie 7-4. Serial Port J Hardware Page Locations 



Location 


Description 


SCQ9Q-SC097 


Resefveia 


scoaa 


ACIA transmit/receive data register 


SCDM 


ACtA status register 


SCD9A 


ACIA command regist&r 


SCQ9B 


AQA control regrster 


SCD9C'$C09F 


Reserved 



7.4 I/O Firmware Support 



Table 7-5 lists the locatfons and values of the I/O firmware 
protocol tab]e. This standardized protocol is available for use 
by any application program. Section 3.4.2 describes how to use 
this protocol. 

Tabie 7-S. Port 1 I/O Firmware Protocoi 



Addresa 


Vslye 


Description 


$C105 


S38 


Pascal 10 byte 


SC107 


sia 


Pascal ID byte 


SCI OB 


SOI 


Gonoric signature' byte ol' f^rmwart 
cards 


SCI DC 


S31 


Same ID as for Super Serial Card 


SC10O 


Sil 


SClii is entfy point of initialization 
fouUne (P)NIT) 



SCI OH 

SC10F 

SC1 10 
sent 



Srr 



Sww 



%5S 



non-O 



SCirr IS entry point of read routine 
(PR Eft D). 

SCI WW hs entry point of write 
routine (PWRITE). 

SCiss IS entry point of the status 
routine [PSTATUS) 

No oplionaf routines 
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■ 7.5 Screen Hole Locations 

Table 7-6 lists the screen hole loca'tions that serial port 1 uses. 
The ACIA register bits are defined Note that the auxijiary-memory locations are reserved for 

.n Chapter 11. Startup value settings, which are listed and interpreted in the 

table. 

rat>i& 7-e. Senaf Port t Screen Hoie Locations 

Auxiliary MerrnDry Screen Hales (firmware loads at pcwer-up reset): 



Location 


Description 




^78 


$9E {ACIA control reg: 8 data + 2 stop bits, 9600 baud) 


S479 


S08 {ACiA command reg: no parity) 


S47A 


$40 (tJags: no echo, auto LF after CR. seysal port) 




Bn 


Interprel^tion 




7 


Echo output on display (0 = ro echo) 




6 


Generate LF after Cfl (Q = no LF) 




B-1 


Always = (reservedj 







1 - connmunication port; = seriai printer 
pen 



^^B S50 (printer width; 30 CDlumns) 

Bit lnl»rpreta1rDn 

7-0 Printer width {0 = do not inserl CR) 

Main Memciry Screen HoJes: 
Loca Hon Description 

$479 Reserved 

$4F9 Reserved 

^579 Printer wJdth (1 - 355; - dtsatjle formatting) 

S5F9 Temporary storage iocation 

^^73 Bit 7 = 1 while the lirmware is parsing a command string_ 

$6F9 Current command character {initiiaUy CONTROL-I) 

S-'^S Bit 7 - 1 if echo to display is on- bit 6 - 1 it firmware is 

to generate a line teed after carriage return. 

S7F9 Current printer coiumn 
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7.6 Changing Port Characteristics 
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Figure 7-1 is a diagram of where the port characteristics are 

stored and moved under different circumstances. As you can 

see trom the figure: ^^ 

• When the power is first turned on, Ihe Monitor reset 
firmware moves the predefined set of port characteristics 
listed in Table 7-3 from ROM into the auxiliary memory 
screen holes listed in Table 7-6. 

• If you specify new characteristics using the System LItilities fcL^ 
Disk, the SUD software changes the values in the auxiliary " 
memory screen holes. ^« 

• The values stored in the auxiliary memory screen hoies are t*" 
affected by power-on reset, but not by either 
fo]- [ GONTRoUX resetI Or a simpte rcoi^rROiTK ses etj . This 
feature is provided so that a port that has been 
reconfigured will remain that way while some other program 
(such as an application program) \s started up. 

• PR#1 causes the firmware to move the characterfSttcs 
stored in the auxiliary memory screen holes into the main 
memory screen holes. 

• A program can change values in the main memory screen 
holes directly. However, the only value guaranteed to be in 
the same place for the entire Apple I! series is the line 
length in main memory location $579. 

• The firmware uses the port as it is defined in the main ^^ 
memory screen holes at any given time. You should use the 
commands listed in Table 7-2 to change them. 



g: 
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Figure 7- 1. Port C/jaract^risttcs 



System Utlimes Disk 

PIN NLmber Selection 

[See Appendix H) 




printer Port 

Corrinnands 

(See Table 7-2) 



Port 1 

Values in 

Firmware Locations 

(See Table 7-Z} 




Port t 

Auxiliary RAM 

Screen Holes 

SeeTabie7-6) 




Fort 1 
Main RAM 

Screen Holes 
(See Table 7-6) 

Reservetl Screen Holes 



7.6. 1 Data Format and Baud Rate 

Serial data transfer consists of a string of ones and zeros sent 
down a wire at a prearranged rate of speed, called the baud 
rate. With most equipment, baud Sfmply equals the number of 
bits per second. 

Belore transfer begins, both sender and receiver look for a 
continuous value of 1: this is called the carrier (Figure 7-2), 
When the value goes to zero, the receiver presumes it is a start 
bit — that is, the bit that designates the beginning of a character 
of data. If it lasts longer than a bit could possibly last, it is 
considered a BREAK signal, which some printers use for 
synchronization. 

If the first zero proves to be a bit, it is interpreted as the start 
bit. Next come the 7 or B data bits (6 is seldom used with 
computers), low-order bit first. If parity is on, it comes next in 
the message. FinaUy, one or two stop bits (with a value of 1) 
appear- The stop bits have a value of 1, like the carrier. The 
next start bit begins transfer of the next character of data. 
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The parity bit provides a simple check oi data validity. Odd 
parity means tlie sender counts the number of ones among the 
data bits, and sends the appropriate parity bit to make the total 
number of ones odd. With even parity, the sender adds the 
appropriate parity bit to make the total number of one-bits even. 
MARK parity is always a 1 bit; SPACE parity is always a zero. 
The receiver can then check that the parity bit is correct. 

If the baud rate is 300, and the data formal is 1 start bit plus 
7 data bits plus 1 parity bit plus 1 stop bit, then the actuai 
transfer rate is about 30 characters per second. 



Figure 7-2. Data format 



n 



1 or MARK 



1 Start 



Data 



or SPACE 



Ho 

Odd 

£van 

MARK 

SPACE 



Parity "I ( J Stop 



gKlMI 



J 



1 





LSB 



MSB 



Carrier 



_^^JTl_aJT^ !_ sr- 



Start 



Odd Stop 

Parity Bit 



Next 

Starl 
Btt 



ASCII letter M = S40; seni as B craia, odd pariiy, i stop bit. 



7.6.2 Carriage Return and Line Feed 

If you are using a typewriter and you push the carriage all the 
way to the right [in other words, position the printing 
mechanism at the iett margin), you have performed a carriage 
return. On the other hand, turning the platen so the paper 
moves to the next line (or using the index key on an electric 
typewriter) is called a line feed. Most typewriters perform a line 
feed automatically after a carriage return, and so the two seem 
to be one — but they are not. 

Carriage return and line feed are separate ASCII codes 
Carriage return is sometimes denoted CR; it is ASCII 
code 13 ($0D). Line feed, sometimes denoted LF, Is ASCII 
code 10 ($0A). (T) on the Apple lie keyboard generates a LF. 
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Some printers can supply a line feed automatically after 
detecting a carriage return; otl^e^s cannot. If the printer does 
not supply a line feed after a carriage return and it fs not 
supplied in the data stream, the printer will keep printing over 
on the same line. On the other hand, if Doth the printer and the 
Apple lie firmware supply LF after CR, double line-spacing wlil 
result. 

If the print head Keeps moving too far to the right across the 
page and then prints many characters on top of one another on 

the right, then the firmware should be instructed to furnish CR 
after a certain line width has been reached. If the printer prints 
too short a line before moving to the next line, then probably 

the firmware is using too small a line width, 

If the printer misses characters at the beginning of each line but 
otherwise prints correctly, there is probabiy not enough time for 
the print mechanism to return to the left margin in response to 
CR. Ydu must use a lower baud rate with such a printer. 

7.6.3 Sending Special Characters 

If you want to send special characters (control characters) to 
the printer without having them intercepted and executed by the 
Appie lie firmware, use the Z command. If the only special 
character that causes a problem is the command character 
(normally CONTROL-I for port 1), you can change just the 
command character instead of using the zap (Z) command. If 
you use the :zap command, the firmware does no formatting: 
that is, it cJoes not checl< line width or insert carriage returns or 
line feeds. This niay be necessary to send graphics to a printer 
or plotter. 

7.6.4 Displaying Output on the Screen 

You can display printer output on the screen, but if the printer 
line width exceeds the 40 or 30 columns you have selected for 
display, you should turn off video display. 
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Serial port 2 is the second of two serial I/O ports available on 
the Apple lie. It is intended primarily as a communication port 
for modems. You can change it to a serial printer port (like 
port 1) using the System Utilities Disk, If you need to change 
port characteristics from a program, read section 86. 

Warning 

Although the Apple tfc serial ports are similar to the Apple 
Super Serial Card, there are many important differences. Refer 
to Appendix F for a summary of these differences. 
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It you change port 2 to a serial 
printer port, refer to the 
descriptions in Ctnapter 7. and 
use 2 instead of 1 tor the port 
number when required. 



Table 8-1 summarf2es the characteristics of this port and is a 
guide to the other information in this chapter. 

The serial port connectors are described in section 11.11. 

Table fl-X. Seriaf Fori 2 Cfraracterisiics 



Port Number 
Commanda 



Ini^al Charsctenstics 
Hardware Page Locations 
Monitor Firmware Routines 
l/Q FimiurarQ Entry Points 
Use af Screen Holes 
Use ol Other Pages 



Serial Port 2 

Keyboard commands 

IN#2 before Tabte B^2 

commands 

IN#2 to accept port 2 input 
PR#1 to echo input to printer 
PR #2 to echo input back to 
port 2 

BASIC commands 
[same) 

Monitor command 

(T) rcoMTROLK D (This command 
works only if tinere is no 
operating system in RAM.) 

All athef Commands- 
Table 8-2 

Table 8-3 

Table 8-A 

None 

Tadie 8-5 

Table 8-6 

In terminal mode, tirmware uses 
auxiligry memory locations $600-S87F 
to store keyboard input, and 
$880-SflFF as a serial inpyt buffer. 
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5. / Using Serial Port 2 



Refer to Table %-^ for Ihe standard 
tirmware entry points that 
Pascal 1.1 and 1.2 use. 



You can access the firmware from BASIC in the usual way — 
that is, by issuing CONTROL-0 (if DOS or ProDOS is in RAM) 
followed by IN#2 or PR#2. Subsequent input and output are 
routed through the modem (or other device) connected to serial 
port 2. 

Note: In terminal mode, the modem port commarids hsted in 
Table 8-2 must follow CONTROL-D and IN#2 {notPHitZ) 
and the command character (which is usually CONTROL-A). 

To transfer files to the modem under Pascal specify REMOUT: 
or #8: . To transfer files from the modem under Pascal, specify 
REf\^IN: Of #7: . 

Table 8-2 lists the commands you can use with serial port 2< 
either from a program or from the keyboard, after you issue 
IN #2. Each command must be preceded by CONTROL-A (the 
command character). As soon as you issue the command 
character, the serial port firmware displays a flashing question 
mark cursor to indicate it is awaiting a command. If you press 
rRETURNQ , you get the current video cursor again. 

You do not have to press [ return ) after commands. 

Note: The commands themselves are letter commands, not 

control characters. 
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Tabte B-2. Modem Port Commands 

CDmmand I>esc Option 

nnn 



nnB 



no 



Set new line width of nnn (from 1 thromgh 255). this must De 
followed immediately b;^ M (see below) or by carriage return. 



Set baud rate to v&\ue 


correspond fng 


to 


nn: 




nn 


HaX9 






nn 


Rate 


1 


50 






9 


1B0D 


2 


75 






ID 


2400 


3 


110 (1109.92) 






n 


3&0D 


4 


135 (134.5B) 






12 


4600 


5 


150 






13 


7200 


6 


300 






14 


9600 


7 


60O 






15 


19200 


Q 


120D 










Set data format to valjes correspondinig 


to n 




n 


Data Bits 






StDp 


Bits 





S 






1 




1 


7 






1 




2 


6 






1 




3 


5 






1 




4 


B 






z 




5 


7 






2 




6 


e 






2 




7 


5 






2 
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Table 8-2 — Continued. Modem Port Commands 

Commanil DescnptJDn 

\ Echo oulput on tile screen. 

K Disabfe automatic (iine feed after carriage return. 

L Generate line teed after carriage retjm. 

nnnN Set lire width to nnn [ffom 1 through 255); da not echo output on 

the screen. Note: ON does not turn off automatic generation ot 
carriage return; to do so, use Z cgmmand. put directly in 
locairion $57A, or use the System UtiEities DSsk. 

nP Set parrty corresponding to n: 





n 


Parity 







None 




1 


Odcf 




2 


None 




3 


Even 




4 


IVone 




5 


MARK (1) 




6 


None 




7 


SPACE (0) 


Q 


Ouit terminal niiOde. 


B 


Reset 


port 2 (Table 8-3] and exit ft-om seriaf port 2 firmware. 


S 


Send 


3 233 m:(llisecDnd BREAK ctiaracter. 


T 


Enter tarminal mode. Use this command after ilN#2 onlv. Ms 



you follow this command by PR#2, the Apple lie will echo input to 
output. {If the other devhce does so too, ttie first character entsred 
will loop endleEslVn iocking up the system. Lise [ cqntrqi. H fiesetI to 
gel out.) 

Z Zap (ignore) further command characters until (_cgmBQLKPifSErj . Do 

not format otilpjt Of insert carriage returns into output stream 

(CONTROL ) -rn This command from a remote device puts the Apple l(c m terminal 

mode if IN#2 is already in effect. It is the same as ( cqnthqj. ) -TO fD 
typed locaEly. 

CcorigHoLX fl) This command from a remote device undoes the terminal mode 
command. If IW#2 and PR#2 are in affect, (he remote keyboard 
and display become Ihe input and output devices of the local 
Apple lie. It is the same as Cc qnthqITK aI fol typed locally. 
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Ttie command character starts off as COr^TROL-A for the 
communication port. You can change it to a different control 
character by typing the current control cinaracter followed J^ 

immediately by the new control character you want. This is 
useful if you want to be able to send CONTROL-A to the output 
device without firmware intervention, J4^ 

For example, to change the command character from 
COMROL-A to CONTROL-V, simply press f control K D 
( CONTROL H V). (CONTROL-V and CONTROL-W are the 
recommended substitute control characters.) To change the 
command character back again, press f corfrnoL K D 

{ CONTRQL> rA). 

Warning JJ^ 

Do not use f control ] <^, -(c), -(h), -(J), -Q), -(T), {m) or <y): 

Apple i/c firmware may intercept ttiese controi characters, ^ 

causing unpredictabfe results. 

Tfie followtng are examples of valid commands and command 
sequences. 

Enable echo to the screen: ^^ 

t CONTROL V TD (T) jjj^ 

Send a BREAK character to a remote device: 

CCCTTrROL> fA) CE) tf** 

Change the control character to CONTROL-V {For example, so ^ 

you can send CONTROL-A as part of a character stream.): ZjZ 

(CONTROL ) -Civl CcontrolK V) [ CONTROL h fjl (command) 
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8,2 Characteristics at Startup 



After power-up, the firmware sets the configuration given in 
Tadle 8-3. These values are stored in the auxiliary-memory 
screen holes (Table 8 6). 

Tabie B'J. initraJ Charact&rfstics of Communication Port 

300 tjaud 

Eight data bits, no perity bits, one stop bit 

Firmware does rot supply line feed after carriage return. 

Firmware does not insert carriage returns into output stream. 

Firmwarie does not echo Gjtput to the display screen, 

CommBnd ct>aracler Is set to CONTROL-A. 

You can change some of these settings from the keyboard 
using the command character foElowed by one of the commands 
listed in Table 8-2. Section 8,6 describes how port 

characteristics change as a resuit of various activities. 

If you change any of these values using keyboard commands or 
commands from a program, subsequent accesses to the port 
firmware (even by another program) use the new settings 
instead of the power-up values. This allows you to change the 
settings once at system startup, and get the desired 
configuration for subsequent uses. Refer to section 6.6 for a 
complete description of these processes. 
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8.3 Hardware Page Locations 



ACIA stands for Asynchronous 

Communication Interface Adapter, 
a serial I/O chip. Note in 
Chapter 11 that some of the bjt 
assignments for this port differ 
from those for port 1 . 



Table 8-4 lists for serial Port 2 the addresses of its hardware 

registers on page $C0. The registers are internal to a 

6551 ACIA: their bit assignments are described in section 11.11. 

Tabte 8-4, Serisi Port ^ Hardware Page Locations 



LDcation 


Description 


SC0A0-$C0A7 


Reserved 


$C0A8 


ACIA transmit/receive data register 


SC0A9 


ACIA Status register 


SCOAA 


ACIA command register 


SCQAB 


ACiA control register 


SCQACIGOAF 


Reserved 



8A I/O Firmware Support 



Table 8-5 lists the values In the I/O firmware protocol table for 
serial port 2. This standardized protocol is available for use by 
any application program. Section 3.4,2 describes how to use 
this protocol. 

TAbie B-S. Port 2 t/0 Firmware Protocol 
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4 



AOdress 


Value 


Description 




$C205 
SC207 


$38 
$ie 


Pascal ID byte 
Pascal JD t>yie 




$C2DB 


£Q1 


Generic signature byte of iirmware 
cafds 


^ 


$C20C 


*31 


Same ID as for Super Serial Card 




SC20D 


$11 


$Clii is entry point of initialization 
routine (PI NIT}. 


s- 


SC20e 


%tt 


SCIrr IS entry point o1 read routine 
(PREAD). 


Uk' 


EC20F 
EC210 


Sss 


$C1ww IS entry point of write 
routine (PWRITE}. 

$Clss Is entry point oi the status 
routine (PSTATUS). 


^ 


SC211 


non-O 


Mo optional routines 


^ 

-— * 
#- 

"l 
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8.5 Screen Hole Locations 



The ACIA register bits are defined 
in Chapter 11, 



Table 8-6 lists the screen hole locations that serial port 2 uses. 
Note that the auxiltary-memory locations are reserved tor 
startup value settings, which are listed and interpreted in the 
table. 

Table B-S. Sen's! Port 2 Screefj Hoie Locations 

Location Description 

Auxiliary Memory Screen Holes {firmware lQad& values at power-up): 

$47C S1S (ACIA control reg; S data + 1 stop bit, 300 baud) 

S^7D SOB (ACIA command reg; no partty) 

S47E $01 {flags: ro echo, no auto LF after CR. communJcalion port) 



Bit 


Interpretatian 


7 


Echo output on display (0 ^ no echo) 


6 


Generate LF after CR (0 = no LF) 


5-1 


Always = (reserved) 





1 = communication poft; = serial printer 




port 



S47F 



EOQ (IJne length: do not add any CR to output stream) 
BK interpretation 

7-D Line length {0 = do not insert CR) 



Main Memory Screen Holes: 

SA7A Reserved 

S4FA Reserved 

S57A Line lengtr> [1 - 255: - disable formatting) 

S5FA Temporary storage location 

S67A Gil 7 = 1 if and only if the firmware is currently parsFng a 

command string, 

5fiFA Current command eharacler (initially CONTROL-IJ 

S77A Bit 7 1 if echo to display is on; bit 6 = 1 <f firmvi/ere is to 

generate a line feed after carrjage return. 

S7FA Current column 



S.5 Screen Hole Locations 
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8.6 Changing Port Characteristics 



Figure 8 1 is a diagram of where the port characteristics are 
stored and moved under different circumstances. As you can 
see from the figure: 

• When the power is first turned on, the Monitor reset 
firmware moves the predefined set of port characteristics 
listed in Table 6-2 from ROM into the auxiliary memory 
screen holes listed in Table 8-6. 

• If you specify new characteristics using the System Utilities 
Disk, the utility software changes the values in the auxiliary 
memory screen holes. 
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The values stored in the auxiliary memory screen holes are 
affected by power-on reset, but not by either 

rgn- TcoNTHOL K RESEf) or a simple [ control K reset]. This -^ 

feature is provided so that a port that has been ET^ 

reconfigured will remain that way while some other program 
(such as an appiication program) is started up. 

IN#2 causes the firmware to move the characteristics 

stored in the auxiliary memory screen holes into the main ^.^ 

memory screen holes. JiiM 

A program can change values in the main memory screen 
holes directly. However, the only value guaranteed to be in ^^ 

the same place for the entire Apple II series is the line S» 

length in main memory location $57 A. 

The firmware uses the port as it is defined in the main m^ 
memory screen holes at any given time. You should use the 

commands listed in Tabie 8-2 to change these _ ^ 

character^ sties. UL^ 



m^ 



l»- 



e- 
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F^ure 5-T. Poff ? Charactsfistics 



Sv&tem Utilities [>isk 

PIN Number Selection 

(See Appendix H) 




Port 2 

Values In 

Flrinware Locations 

See Table e-3) 



Com mun I cation Port 

Commands 

[See Table G-2) 





Port 2 

Auxiliary RAM 
Screen Holes 
(Se« Table a-6] 




Port 2 

MaJnRAM 

Screen Holes 

{See T&ble 8-6) 

Reservod Screen Holes 



8,6. 1 Data Format and Baud Rate 

Section 7,6,1 describes data format and baud rate, and 
explains how they apply to printers. Refer to that section or to 
the Glossary for the definition of terms. 

A noteworthy characteristic of data communication is its 
strangeness: sometimes the oddest changes make a given 
communication arrangment work or not work. You must keep 
this notion firmJy in mind when working with serial port 2. For 
example, modem communication involves quite a few eiements 
(Figure 8 2): 

• the Apple lie and its firmware, with the baud rate, data 
format, and other characteristics you have selected 

• the cable from the Apple lie to the modem 

• the modem 

• possibly an acoustic coupler for a telephone handset 
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• the telephone lines, with their switching equipment, boosters, 
and noise 

• some combination of modem, cable, and computer or 
terminal on the other end. 



Figure 8-2, Devices m a Typical Communication Setup 



Loca] DTE 

IDbIh Terminal 



Local [>CE 

(Data Commun leal Icn 

Equkpm«<nt) 



Transmission Line 



Remote DCE 



Remote DTE 



J 

.MM 




J 



J 



As you can imagine, some method is required for success. If 
you tiave problems, change only one variable at a time, and 
then cycle through the other variables one at a time. Take 
nothing for granted. The data format advertised for an 
information service, for example, may be different from the one 
you end up using with the Apple tic. 

&£,2 Carriage Return and Line Feed 

If you are communicating with a computer or terminal, carriage 
return and iine feed may or may not be involved. Start off 
without generating them, and turn on automatic generation oniy 
as needed. They are descnbed as used with printers in 
section 7,6.2. 
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B.6.3 Routing input and Output 

This section discusses the possible ways that serial port 2 can 
route information. Sometimes the cause of communication 
problems is that information is not going where you think it is, 
or it is and you cannot see evidence of the fact Figures 8-3 
through 8-6 show some of the patterns of information flow you 
can select. This section and the following subsections tel[ you 
how to use them. 

It is best to read ari of this material as a unit: questions that 
arise while you read one description may be answered 
elsewhere. 
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Figure S-3. Effect of !f^!f^2 



Display 



f=\ 



Printer 



o 



Communfcatlon 
Device 



■4^ 



Remole 

Communication 

Device 



1 rn yid rn 2 



Porl 1 
FW 




Port 2 
FW 
















MON 








, . 







Remote 

Terminal 
or Compular 



Keyboard 



For a further description of wliat 
lerminai mode does and how to 
get into and out of it, refer to tlie 
last section of this chapter. 



The simplest serial port 2 command is IN#2 (Figure 8-3). 
Port 2 becomes the input device. Data coming into the port 
gets passed to the input buffer (page 2 of main memory). 
Applesoft firmware and system software can see the data and 
carry out commands in the normal way. 

Of course, you can aiso use just the PR#2 command — for 
example, it you want to send a listing to the modem. 

To use port 2 for data communication, you ordinarily put it into 
terminal mode. Following iN#2, typing ( control > fD gets the 
attention of tire port 2 firmware, which displays a blinking 
question mark (?) as a prompt. Now type (T) to put the 
computer in terminal mode. In this mode, the firmware displays 
a blinking underscore character (_) as a prompt. 

In the discussion that follows. local refers to your Appie lie. 
Remote refers to some other device, usually in a distant 
location and at the other end of a communication link. The 
remote device can be any ASCII-generating unit: a terminal or a 
computer. 



J 



y ^ 









154 I 



Chapter 8: Serial I/O Port 2 



E 

E 
E 
E 

r 



ff a remote computer is another Apple lie or an Apple II series 
machine with a Super Serial Card in it then most of the 
commands described here apply to it as well. 

H&lf Dupfex Operation 

In half-duplex operation, information can flow from A to B or 
from B to A, but in only one direction at a time. In a half-duplex 
setup, the host does not echo back to the terminal what the 
terminal sends it For half-duplex operation, use rN#2 and 
( CONTROL > [D (T) (Figure S-4) whether the Apple lie is the host 
or the terminal. 



Figure ff-4. Effect vf fN}^2 and T Command (Haff Dupfsx) 
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IH#2 plus CcqntrolJ -CaT] (T) is the best way to set up the 
computer for auto-answer operation. The T command allows 
port 2 firmware to exchange Information with the local modem 
without interference from the local firmware or system 
software. (The remote device can always cancel the 
T command with ( control K rI if necessary, and restore 
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termiraf mocfe with [ control ] -(T}.l Avoiding PR#2 at this pofnt 
means that the Apple lie can operate as a haif-dupiex terminal^ 
hatf-duplex host, or full-duplex terminal. (The remote device 
can also issue C control K X) PR#2 if PR#2 is required at the 
local computer.) 



^ 



^ 



In half-duplex operation, the output liook is available for other 
uses. For example, you can issue PR#1 to print incoming ^ 

messages from port 2. Use the CcontrqlX a) CD command to ttL^ 

display information on the screen, 

Fuli Duplex Operation J^ 

In tull-duplex operation. Information can flow from A to B and 

from B to A simultaneously. Typically, one of the computers (the t^ 

host computer) echoes its input to output, so the other ^*- 

computer (the terminal) can easily verify that the communication 

is taking place. ^ 

Figure 8-5 shows the flow of information when the Apple lie is a 
full-duplex terminal. (The setup commands, IN#2 and ^_* 

( CONTROL K a^ CL), are the same as for half duplex.) j^ 

If your Apple lie is the terminal in full-duplex operation, use the 

N command to turn off echoing input to the screen. If the ^ 

Apple lie does echo input to the screen in this setup, everything ^^ 

you type will appear twice: once trom the Apple lie and once 

from the host computer, jj^ 

In this mode of operation, if you echo input to the printer you 
can get a printed record of both sides of the communication ^^ 

session: the input from the host, and the Apple ilc output as i^ 

echoed by the host. 
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Figure 8-S. Effect of fNii^2 ana T Command fFufi Duplex Termmai) 
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Figure 8-6 shows the flow of information when the Apple 11c is 
a full-duplex host. In this case, the local Apple lie must echo 
input to output for the remote device. The setup corrmands 
include PR#2 in this case. 



8.6 Changing Port Characteristics 



1157 



Warning 

if the Apple tfc echoes input to output and the other computer 
does too. then the first suiysequent keypress wilt echo back and 
forth endfessfy and lock up the Apple tic. This wift require a 

(CONTROLJH RESET] tO QBt OUt. 

ff you echo input to output when using an information service, 
the host wiif end up seeing the echo of what it sent you as 
though you had typed it. 

In this arrangement, the local oulput hook is not available for 
using the printer or other device. To display keyboard and 
port 2 input on the screen, issue fcoNTROLK A) Q}. 



Figure 8-6. Effect of ffV*'2, PR#2 snd T Command (Fulf Duplex Host} 
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Terminal Mode 

Terminal mode makes the Apple IJc act like a dumb termmal — 
one that just sends and receives In formation, but does not 
process it. Input and output flow through special serial I/O 
buffers on page 8 of auxiliary memory. Applesoft firmware and 
system software cannot see or interpret the data: only the serial 
port 2 firmware deals with it. 

(n most terminal mode setups, the firmware will not display 
port 2 input unless you use the ( control K X) (T) command. 

Warning 

When ustng terminal mode, $800-$8FF of auxiliary RAM is used 
for buffering ^ Any data stored there vut'fi be overwritten when 
terminal mode is enabled- 

(coNTytQLH D (T) turns on terminal mode, and (corfrROrK gl (o) 
turns it off. 

The remote device can go into terminal mode, and then turn off 
the local Apple Jlc's terminal mode with The [contrOlX T) 
command. \f it then issues [coNTROL> fAl PR#2, local output will 
go to the remote device. The remote keyboard and display then 
become the input and output devices of the local Apple lie 
processor. This is remote mode. 

In remote mode, the local Apple lie does not use the serial I/O 
buffers (as it does In terminal mode), therefore, local firmware 
and system software detect and interpret all input and output 
data. So, for example, if you type CATALOG at the remote 
device keyboard, the local Apple lie will execute the command 
and list the disk catalog on the remote device's display. (In 
terminal mode, the local computer would simply display the 
word CATALOG on its screen.) 

The remote device can turn the local Apple lie's terminal mode 
&ack on with { CONTROL H T). f coNTPOj^v m (T) typed at the 
remote device only turns on th§ remote devfce"s terminaj mode, 
unless the command character there has already been changed 
to something else. 
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Section 9,1,6 gSvas an eKample o1 

haw to use the mouse as a hand 
control. 



This ctiapter describes the mouse port and hand control (game) 
input capabilities of the Apple lie. The mouse and hand controls 
use the same 9-pin connector on the back panel; the firmware 
uses the port as directed by keyboard or program commands, 

A program can tell If a hand control is connected (section 9.2) 
but not if a mouse is connected, unless the computer user 
moves it. 
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9, 1 Mouse !nput 



Table 9-1 is a summary of the characteristics of the mouse port 
and a guide to the other information in this part of the chapter. 



Warning 

tf you want to ensure compatfbHity with mouse op&ration on the 
Apple fte and other Apple It series computers, always use the 
I/O firmware entry points listed in Tables 9-4 and 9-5. rather 
than dealing with mouse hardware and RAM locations directfy. 

The mouse back panel connector is described in section 11.12. 

Tabte 9- J, M6US& tnput Port Cffaractsristics 

Port Number Mouse Input Port 4 

BASIC commands Turn an [Douse: 

PRINT CHR$<4>"PR#«4":PRINT 

CHR>Ct) 

Turn off mouse interrupts: 
PRIHT"PR*4":PRINT CHHICOJ 
Turn or graphics character set: see 
section 5.2.2. 

initial Characteristics After s reset, all mouse interrupts are 

oft, and the rising edge of XO and YD 
are selected for inten-upts. 

Hardware Page Locations Table 9-2 

Monitor Firmware Routines Nanie 

I/O Firmware Erttry PoinU Table 9-5 and Table 9-4 

Uae at Screen Holes Table 9-5 



^ 

il^ 






9. i. 1 Mouse Connector Signals ^U 

The mouse uses the same 9-pin D-type miniature connector as 

the hand controls. However, the interpretation of the signals g^ 

arriving on the pins differs depending on the commands and ^ 

signals received. The names ot the pin assignments when a 

mouse is connected are shown in Figure 11-37. ^j 
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Section $.22 comains 
recommendations for using 
MouseTexT characters wiin i 
mouse- 



9. 1.2 Mouse Operating Modes 

Later sections of this chapter describe how to set various 
modes for mouse operation. This section tells what the modes 
are for. 

In all the interrupt modes — that is, all but transparent mode — 
the user program should call the SERVEMOUSE routine to 
determine the source of an interrupt as soon as i1 receives one. 

Transparent Mode 

In this mode, a program must read screen holes to check for 
mouse movement. In reality, however, an interrupt routine in the 
Apple lie firmware updates mouse position counters each time 
the mouse is moved, then returns control to the main program 
task. 

This is the only mouse mode available to BASIC programs 

Movement interfupt Mode 

On the Apple lie, a signal called VBLINT can interrupt the 
processor whenever a video veriicaJ blanking signal occurs. 
This provides for efficient program coordination of the mouse 
cursor with mouse movement. 

In movement interrupt mode, the mouse firmware arms VBLINT 
whenever the mouse Is moved at least one count in any 
direction. When VBLINT occurs, program controf passes to the 
vector address contained at locations $3FE and $3FF; the 
Interrupt handler can then update the cursor smoothly to its 
next screen position. 

The receiving interrupt handler must first call SERVEMOUSE 
{Table 9 3) to see if the mouse caused the interrupt. It should 
then call READMOUSE to get mouse status and its current 
X-Y position. The routine can also change the mouse mode and 
position ff desired. 

The maximum amount of mouse movement that can occur 
between successive VBLINT interrupts is limited only by the 
distance someone can move a mouse In one sijttieth of a 
second. 
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Section 11.12 expiains what XO. YO, XI, Y1 are and what they 
mean with respect to mouse movement 



^ 



J 

t^ 

Button interrupt Made ^ 

The Apple lie mouse-button hardware location does not b?*^ 

generate interrupts. However, a program can simulate 

mouse-button Interrupts by polling the button whenever VBUNT ^^ 

occurs, and acting on the interrupt whenever the button state SS^ 

has changed. This alfeviates the program overhead required to 

poll the button constantly to provide fast response. ^j^ 

C^ 

i 
Movement/Button Interrupt Mode ■'. 

This is a combination of the two modes just described. It fj^ 

pro\>ides the best response possible without constant polling of 
the mouse position and button. Processing of a main task can 
be concurrent with cursor and menu updating, as well as 
menu-selected command processing. 

Vertical Blanking Active Modes 

These modes are the same as the four just described except 
that they allow VBLINT interrupts to be sent to the user. 

9,1.3 Mouse Hardware Page Locations 

The soft switches assigned to the mouse interface are shown in 
Table 9-2 On power-up or reset, the hardware selects the ^^ 

rising edge of XO and YC and masks out all mouse interrupts, Ul^ 

Mouse firmware sets interrupts in response to mode settings 
under program control. The vertical blanking interrupt (VBLINT) 
is armed if the mouse button is pushed or there is a change of 
at least a count of 1 in the XO or YO coordinate. Since VBL 
occurs every sixtieth of a second, at most that amount of time 
will elapse before the resulting interrupt can be acknowledged 
and acted upon. To reset the VBL interrupt, read SC070. 

Software can also select which edge of XO and YO information 
will cause the XINT or YINT. 



p. 



Once an interrupt has occurred, you can read the mouse's 

XI and Y1 direction in data-bus bit 7 by reading address SC066 

and $G067, respectively. 

A program can read the status of the soft switches by reading C^ 
one of the locations $C040 $C043 and then testing data bit 7. ^^ 
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A Warning 

Tabfe 9-2 fs included here for your information: however, you 
Appends E explains how the Should use the buift-fn firmware to access the mouse, ff you do 

firmwafe handles interrupts. ^vr/te your own mouse interrupt handler it should enable the 

main bank-switched memory, set up its own IRQ vectors at 
addresses SFFFE and SFFFF. keep track of video modes and 
the alternate stack, and check for the interrupt source in the 
same manner as the mouse firmware listed in Volume 2 of this 
manual 

Using the built-in firmware is much easier and guarantees 
compatibility with all other Apple ft series computers. 
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Tabie 9-2. Mouse Hardware Page LocAlions. (1J When iOUDlS is on, 
SC058-SC05F do not affect mouse, and $C05E and SC05F become DHtHES 
(Tsbts 5-3}- {2} Read or write to $C07x stso resets V8UNT artCf triggers papdie 
timers- (3) These work only if iOUDlS is off. (4) Tfiis focatton is stso ihe Ls ] frey 
(Table 4- f/ (5) This is afso the facation of the shift-key moH (Appsnm fh 



b^ 



Action 
W 

W 



R/W 



Hex 
SC07E 



Naine 

IOUDlS 



$C07F IOUDlS 



Fufiction Noteft 

On: disable lOU access for (1) 

addresses SC05& to ICO&F; 
enable access to DHIRES switch 

Off: enabte lOU access Tor {%) 

addresses 50058 to SC05F: 
disable access to DHIRES 

switch 



R7 


$C07E 


RD10UDIS 


Read IOUDlS switch (1 off) 


[2) 


U^ 


R;'W 


$C05B 


DISXY 


Dtsatile (mask) XO and YO 
movement interrupts 


[3) 


Ryw 


$CQ59 


ENBXY 


Enabfe (allow) XO and YQ 
movement interrupts 


(3) 


^ 


R7 


$CC40 


RDXYMSK 


Read status of XO/YQ interrupt 

rnask (1 ^ mask on) 




^ 


R 


SC048 


RSTXY 


Reset XD/YO interrupt flags 




"* 


R/W 


SC05C 


XOEOGE 


SelBCt rising edge of XO fof 


(3) 


.^ 



$C05D XOEDGE 



R7 


$C042 


RDXOEOGE 


n 


$C015 


RSTXINT 


R/W 


$ca5E 


YOEDGE 


RAW 


IC05F 


YOEDGE 


R7 


SC043 


RDYOEDGE 


R 


SC017 


RSTYit^T 


R/W 


SC05A 


DISVBL 


R/W 


SG05B 


ENVBL 


R7 


$CQ4l 


RDVBLMSK 



RW 



SC019 RSTVBL 



SCQ70 PTRIG 



Interrupt 

Select falling edge of XO for (3) 

interrupt 

Read status of XO edge selector 

(1 = failing) 

Reset mous^ XD interrupt flag 

Select rising edge of YO for (SJ 

interrupt 

Select falling edge of YO for (3) 

interrupt 

Read! status of YO edge selector 
= falling) 

Reset mouse YO interruipl flag 

Disable (mask) VBL interrupts [3) 

Enable (allow) veL interrupts [3) 

Read status of VBL interrupt 
mask [1 = mask on) 

Read and tfien reset VBLINT 



Reset VBLIWT flag; trigggr 
paddle llmer 






J 



u< 
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T9bie 9-2 — Continued. Mouse Hardware Page Locations 



Action 


Hex 


Name 


Function 


Notes 


R7 


$C061 


RDBTNO 


flead hand control button status 
(1 ^ pressed] 


(4) 


R7 


$C063 


RD&3 


Rsad moLJEe button status 
[D = pressedl 


(5} 


R7 


$ca66 


MOUX1 


Read status of XI (mouse 
X direclion) (1 - high) 




R7 


$C0G7 


M0UY1 


Read status of Y1 (mouse 
Y direction) ■(I ^ liigh} 





9,1,4 f/0 Firmware Support 

The Apple lie supports the mouse with firmware starting at 
address $C400. This firmware is necessary because the mouse 
requires fast, transparent interrupt processing to work 
eTtectfvely. 

In assembly language, which you might need to use for 
sophisticated mouse applications, you can use direct firmware 
support. To enable the mouse, first load a mode byte into the 
accumulator (and $C4 in X, $40 in Y), and then do a JSR to the 
firmware routine called SETMOUSE {Table 9-3). Valid mode 
bytes are; 



soo 

SOI 
$03 
$05 
$07 
$08 
$09 
$0B 
SOD 
$0F 



Turn mouse off 

Set transparent mode 

Set movemeni-interrijpi mode 

Set bLJttor-interrtJpt mode 

Set movement- or button-interrupt mode 

Turn mouse off, VBLIMT actiwe 

Set transparent mode, VSLINT active 

Set mowement-!r>terrupt mode, VBUhJT active 

Set button-interrupt mode, VBLINiT active 

Set movement- or button-interrupt mode, VGLINT active 



The firmware will then initfalize the mouse. To read the current 
position and status of the mouse, first load SC4 into the 
X register, load $40 into the Y register, save processor status, 
disable interrupts, and then JSR to the firmware routine called 
READMOUSE (Table 9-3), which Stores the information in the 
port 4 screen holes (Table 9-5), 

Table 9-3 lists the mouse port firmware routine offsets. Each 
address contains the iow byte of the entry point of the routine 
described. The calling setup for all routines (except 
3ERVEMOUSE) is the same: the X register must contain $C4, 
and the Y register must contain $40. When the routine has 
finished, the A, X. and Y register contents are undefined. 
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Tabie 9-3. Mouse Firmware Routines 
Location Offset For 

SC412 SETMOUSE 



SC413 



SERVEMOUSE 



SC414 



READMQUSE 



SC415 



CLEAR MOUSE 



SC416 



SC417 



POSMOUSE 



CLAMPMOUSE 



SC1 18 



HOME MOUSE 



Description 

Sets the mouse mode lo the value 

in the accumulator 

Input: A register contains mode 

[see $7FC. Table 9-5)- 

Output; Carry bit means mocte 

was iegal, carry bit -^ 1 means 

mode was not legal. 

Services mouse interrupt if needed 

Input; X. Y, A registers — doesn t 

matter 

Output: Carry bit = means 

mouse caused the interrypt; carTy 

bit = 1 means sometlning else 

caused it. 

Ttiis routine updates $77C to show 

whEch event caused the interrupt 

(values 10 Table 9-5). 

Updates screen holes to show 
current mouse X Y position and 

tiutlon status; clears VBLINT, 
button gnd moi^ement interrupt bits 
in the status byte. Don't re-enat)le 
interrupts until after retrievinig 
position values. 
Output: Carry bit - 

Sets the mouse position to 0. 

though not necessarily withm 

clamping boundaries; ieaves button 

and interrupt bits In status byte 

unchanged. 

Output: Carry btt = 

Sets t^le mouse coordinates (o new 

values. 

Input- X and Y screen hoies 

contain new X and Y positions, 

Output: Carry bit = 

Sets new clamping boundaries (see 
Table 9-5). Does not aJfecl mouse 
position or update mouse position 
screen holes; use READMOUSE tq 
do that. 

Input: A register = means set 
new X boundaries; A register = 1 
means set new Y boundaries. 
Output; Carry bit = 

Sets the internal mouse position to 
the uppef-left corner of Itie 
clamping window. Does not update 
mouse position screen holes; use 
READMOUSE to do that. 



M 



1^ 
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Table 9-3 — Continued. Mouse Firmware Routmes 

SC419 I^JIT^^OUSE Sets startup internal values; does 

not update mouse-position screen 
holes. 
Output; Carry bit = 

Here is a sample sequence of events and calls. 

1. Four screen holes contain the mouse's X and Y coordinates, 
and one contains the status of the last mouse movement 
(Table 9-5). 

2. Call INITVtOUSE 

3. Inhibit interfupts. set up the boundaries you want, then call 
CLAMPMOUSE 

4. Use POSMOUSE, HOMEMOUSE or CLEARMOUSE to 
position the mouse where you want it 

5. Put the mode (see address £7FC in Table 9-5) in the 

accumulator, then caJI SETMOUSE. 

6. If you have set one of the interrupt modes, then when an 
interrupt arrives, call SERVEMOUSE to determine the sotirce 
of the Jnterrupl. 

7. Disable interrupts and call READMOUSE. Retrieve the 
position values, then re-enable interrupts. 
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Pascal Support 

Table 9-4 lists the locations and vaiues of the I/O tirmware 
protocol that Pascal 1.1 and 1.2 use. However, Pascal must use 
a special attach driver to support the mouse. 

Table S'4. Mouse Port i/0 Ftrmwafe Protocoi 



Address 


Value 


Description 


SC405 


S3B 


Pascal ID byte 


SC407 


$18 


Pascal ID byte 


ig4oa 


$01 


Generic signature byte of firmware 
cards 


SC4QC 


$20 


2 - X-Y pointing deyice; 
■■■ identification code 


$C40D 




Initialization routine (not 

im piemen led; returns error code) 


$C40E 




Standard read routine (not 

impiemented; returns error code] 


$C40F 




Standard write rojtine {not 
impiemented; returns error code] 


$C410 




Standard status routine (not 
implemented; returns error code) 


$C4H 


$00 


Optional routines follow. 


$C4FB 


$D6 


A mouse identification l^yte 



J 

J 

1 



'J 



Urf 



U^ 
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BAStC and Assembfy-Language Support 

In BASIC, before you can get input from the mouse, you must 
turn it on by printing PR#4 and then CHRS(1). This sets 
transparent mode. After that, re-enable video output with PR#3, 
and take subsequent input from the mouse by issuing IN #4. 
The first input statement after that (INPUT X,Y,S) initializes and 
enables the mouse, and returns a three-element string: 

+ xxxx, + yyyy, + st 

representing the x^coordinate, y-coordinate and status digits. 

The coordinates will' be integers between and -1-1023. These 
are called the clamping boundaries of the mouse. 

The sign preceding the status digits is normally positive; it 
becomes negative when yoy press a key on the keyboard. 

The first digit, s, of the status is 0. The second digit, t, of the 
status is 1 if the mouse button is still pressed, 2 if it was just 
pressed, 3 if it was just released, and 4 if it is still released. 

To disable the mouse: 



PRIMT CHR$Cq>"PR'^" 
PRINT CHR*CO> 
PRINT CHRC4>"PR'3" 

9. 1.5 Screen Holes 

Table 9 5 lists the screen holes that the mouse firmware uses. 
Note that the mouse firmware reserves port 5 screen holes for 
its own use. Also, the auxiliary-page counterparts of the port 4 
addresses are reserved for startup values. 

Note: Some screen holes are different for the Apple lie 
mouse. Refer to Appendix F. 
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Tabfe 9-5. MousB Psfiph&ra! Card RAM Locations 

Scratch Area: 
Location Description 



Low byte of clamping minimLm 
$4F9 Low byte of clamping maximLim 

$578 High byl© of clamping mimirnum 

$5FS High byte ol clamping maximum 

Part 4 Screen Holes: 
Location Description 



J 
'J 
"J 



J 

U4 



$47C 


Low byte 


of X coordinate 


$4FC 


Low byte 


oi Y coordinate 


SS7C 


High byte 


of X coordinate 


S5FC 


High byte 


of Y coordinate 


$67C 


Reserved 




S6FC 


Reserved 




S77C 


Status byt 


e 




Bit 


1 Equals 




7 


Button down 




6 


Button was down on last read and still 
down 




5 


Movement since isst read 




4 


Reserved 




3 


Interrupt from VBLiNT 




2 


Interrupt from button 




1 


Interrupt from movement 







Reserved 


S7FC 


Mode byte (current mode; mask out bits 4-7 when tej 




Bit 


1 Equals 




7-4 


Reserved 




3 


VBLINT active 




2 


VBLINT Interrupt on button 




1 


VBLINT intenrupt on movemeril 







Mouse active 




Port 5 Screen Holee: 


Reserved 



k^ 
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R 1,6 Using the Mouse as a Hand Control 

This section describes how to use the mouse as if it were a s$t 
of hand controls, or an X-Y pointing device in port 4. if you 
turn the mouse on, the Monitor hand-control (game paddle) 
routines will take input from the mouse. This is possible 
because the mouse and the hand controls all use the same 
back-panel connector. 

You can run a BASIC program that uses the PDL function to 
read from the mouse by doing this: 

1. Start up the system with the BASIC program that uses 
paddles. 



2. Type PR '4 and press Qreturn) to turn on the mouse. 

3. Press (coNTRop-(X) (return] to initiaiize the mouse. 



4. Type PR'D and press ( return ) to restore output to the 
screen. 

5. RUN the program, 

PJay the game using the mouse instead of the paddles. 

Note: Many copy-protected games will not work with a 
mouse. Also, many games don t use built-in firmware fof the 
paddles. 



^^ 



:^ 
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9.2 Game Input 



CompJeie electracai specificaiions 
of these inputs are given in 
Chapter 11; Table 11-22 stiows tne 
connector pin numbers.. 



The Apple lie supports game paddles, joysticks, and other hand 
controls connected to the DB-9 connector on its back panel. 
Table 9-G is a summary of game input characteristics. 

Tabfe^ 9-6. Gam& input Chsractmstics 



Part Number 


Wone 


Commands 


None 


Initial 
Characteristics 


Game inpjts cannot be disabled. 


Hardware Page 
Locations 


Description 


$C061 


Switch inpiit and rS"] 


SC062 


Switch input 1 and [*} 


SC063 


Mouse button. (Sense is opposite that of SCOSi to 
distinguish it from paddle button} 


$C064 


Analog input (paddle) 


$C065 


Analog input (paddle) 1 


$C070 


Trigger paddJe timer 


Monitor 

Firmware 

Routines 


Mame Description 


SFBIE 


PREAD Read a paddle p>o&ition 


\IO Firmware 
Entry Poinla 


None 


Use of Screert 

Holes 


None 



J 

'J 

'J 



1 

U^ 



^ 

U^ 



^ 
tM 



u^ 

^ 



9,2, 1 The Hand Control Connector Signals 

Several inputs are available on a B-pin D4ype miniature 
connector on the back of the Apple lie; two one-bit inputs, or 
switches^ and two analog inputs. You can access all of these 
signals from your programs. 

When you connect a pair of hand controls to the 9-pin 
connector, the rotary controls use two analog inputs, and the 
push-buttons use two one-bit inputs. However, you can also 
use these inputs for many other jobs. For example, two analog 
inputs can be used with a two-axis joystick. 



1 
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Switch inputs (SWO and SW1} 

The two one-bit inputs can be connected to the output of 
another electronic device that meets the electrical requirements 
(Chapter 11). or to a pushbutton. When you read a byte from 
one of these locations, only the high-order bit — bit 7 — is vaiid 
inlormation: the rest of the byte is undefined. From machine 
language, you can do a Branch Plus or Branch Minus on the 
state of bit 7. From BASIC, yoii read the switch with a PEEK 
and compare the value with 12B. if the value is 128 or greater, 
the switch is on. 

The memory locations for these switches are SC061 , SC062 and 
$CD63, as shown in Table 9-6. Switch and switch 1 are 
permanently connected to (^ and (T) on the [keyboard; these 
are the ones connected to the buttons on the hand controls. 
Location SC063 is a second address for the mouse button, so 
that a program can distinguish it from an (&} keypress. When 
the mouse button is pressed, $C063 (Bit 7) goes from 1 to 0, 
and $C061 (Bit 7) goes from to T When the mouse button is 
pressed. SC063 (Bit 7) goes from 1 to 0. 
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Anafog inputs (POLO and POL 1) 

The two analog inputs are designed for use with 150K ohm 
variable resistors or potentiometers. The variable resistance is 
connected between the +5V supply and each input, so that it 
makes up part of a timing circuit (refer to section 11.13 for 
details). The circuit changes state when fts time constant has 
elapsed, and the time constant varies as the resistance varies. 
Your program can measure this time by counting in a loop until 
the circuit changes state, or times out. 

Before a program can read the anaiog inputs, it must first reset 
the timing circuits. Accessing memory tocation SC070 does this. 

As soon as you reset the timing circuits, the high bits of the I 

bytes at locations SC064 through $C067 are set to one. If you jj* 

PEEK at them from BASIC, the values will be 128 or greater --^ 

Within about 3 miiiiseconds. these bits wiJI change back to t 

zero— byte values less than 128— and remain there until you .-^ 

reset the timing circuits again. The exact time each of the bits -^ 
remains high is directly proportional to the resistance connected 

to the corresponding input. If these inputs are open-^no —^ 

resistances are connected^the corresponding bits may remain i^ 
high indefinitely. 



LUi 



J 
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Vdu can read and r^rBad Ihe same 

paddle at arbitrarily short intervals. 
However, you must wait at least 
3 millisecDnds between reading 
one paddle and reading a different 

paddle. 



9.2.2 Monitor Support 

To read the analog inputs from machine language, you can use 
a program loop that resets the timers and then increments a 
counter until the bit at the appropriate memory location changes 
to zero, or you can use the built-in routine PREAD. BASIC and 
other high-level languages also include convenient means of 
reading the analog inputs — refer to your language manuals. 

PREAD 

The Monitof routine PREAD (at address $FB1E) places in the 
Y register a number between $00 and $FF that represents the 
position of a hand control. You pass the number of the hand 
control in the X register. 

Warning 

it the hand controt number you furnish in the X register does 
not equBf or 1, strange things may happen. 






Warning 

The paddfe and vertical blanking both use $C070 if you are 
reading the paddles and using VBL interrupts, disable interrupts 
before casing PREAD. 
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The System Monitor is a set of subroutines in the Apple lie 
firmware. The Monitor provides a standard interface to the 
built-in I/O devices described in Chapter 1. Many of the t/0 
subroutines described in Chapters 3 through 9 are part of the 
System Monitor, 

DOS (but not ProDOS) and The BASIC interpreters (Appendix E) 
use these subroutines by direct calls to their starting locations. 
The starting addresses for all of the standard subroutines are 
listed in Appendfx C, If you wish, you can call the standard 
subroutines from your programs in the same fashion. 

You can perform most of the Monitor functions directly from the 
keyboard- This chapter tells you how to use the Monitor 

• to took at one or more memory localJons 

• to change the contents of any location 

• to wrrte programs in machine language to be executed 
directly by the Apple lie's microprocessor 

• to move and compare blocks of memory 

• to invoke other programs from the Monitor. 



10. 1 invoking the Monitor 



The positive and negative decimai 
equivalents of Montior iocations 
are listed in Appendix C En 
addition, Appenciix H contains 
conver&ion tables from one 
rnjm[>ering system to another. 



The System Monitor starts at memory focalion SFF69 {-151). To 
invoke the f^onitor. you make a CALL statement to this location 
from the keyboard or from a BASIC program. When the Monitor 
is running, its prompting character, an asterisk (*), appears on 
the left side of the dispiay screen, followed by a cursor. 
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A Monitor command can include three kinds of jnformation: 
addresses, data values, and command characters. You type 
addresses and data values in hexadecimal notation, 
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To use the Monitor, you type commands at the Iteyboard. When ^J 

you have finished using the Monitor, you return to the BASIC jj 

language you were previously using by pressing 

( CONTROL K reset] , by pressing (contpolK cI and then [return] , 

or by typing 3D0G, which executes the resident program — 

usually Applesoft — whose address is stored in a jump ** 

instruction at location $3D0. ^ 

Note: If DOS or ProDOS is connected via the standard I/O ** 

links (Chapter 3}, then you can issue commands to (t from _^ 

the Monitor. Under this arrangement, errors will return |^ 

control to BASIC rather than to the Monitor. ** 

If you want to have (coivtrol] - ( reset) return you to the Monitor, t^j 

load the values $69, $FF, and $5A into the three locations ^ 
starting at address $3F2 (the reset-vector address and the . 

power-up byte). j^ 



10.2 Syntax of Monitor Commands ^ 

To give a command to the Monitor, you type a line on the _^ 

keyboard, then press CreturnI . The Monitor accepts the line U^ 
using the standard I/O subroutine GETLN described in 

Chapter 3. A fvlonltor command can be up to 255 characters in ^^ 

length, ending with a carriage return. ,L^ 



lUM 



When the command you type calls for an address, the Monitor ^^ 

accepts any group of hexadecimal digits If there are fewer than 1^1 
four digits in the group, it adds leading zeros: if there are more 

than four hexadecimal digits, the Monitor uses oniy the last four ^ 

digits. It follows a similar procedure when the command syntax [W 
calls for two-digit data values. 



Each command you type consists of one command character, , 

usually the first letter of the command name. The Monitor liS^ 

recognizes 22 different command characters. Some of them are 
punctuation marks, some are letters (uppercase or lowercase), 
and some are control characters. 



J 

J 



J 
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Note: Although the Monitor recognizes and interprets them, 
control characters typed on an input line do not appear on 
the screen. 

This chapter contains many examples of the use of Monitor 
commands. Some of the data values displayed by your Apple IJc 
may differ from the values printed in these exampies, because 
they are variables stored in programmable memory. 



10.3 Monitor Memory Commands 



When you use the Monitor to examine and change the contents 
of memory, it keeps track of the address of the last location 
whose value you inquired about and the address of the location 
that is next to have sts value changed. These are called the last 
opened location and the next changeable locatton 

Warning 

Because locations $C000 through $COFF contain speciat 
hardware circuits, issuing any command that reads or writes on 
this page can have unpredictabie. and perhaps disastrous, 

results. 



10.3.1 Examining Memory Contents 

When you type the address of a memory location and press 
C return! the Monitor responds with the address you typed, a 
dash, a space, and the value stored at that location, like this: 



•EOOO 
EOOQ- 4C 

0033- flA 

« 

Each time the Monitor displays the value stored at a location, it 
saves that address as the last opened location and as the next 
changeable locatjon- 
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10.3.2 Memory Dump 

When you type a period {.) fotlowed by an address, and then 
press (RETURN] , the Monitor displays a memory dump: the data 
values stored at all the memory locations from the one following 
the last opened location to the location whose address you 
typed toiiowing the period. The Monitor saves the last location 
displayed as both the last opened location and the next 
changeable location. In these examples, the amount of data 
displayed by the Monitor depends on how much targer the 
address after the period is than the last opened location. 



^£0 



0020- 


00 




* .2B 






0021 - 


28 


00 18 OF 


0028- 


1^8 


06 DO 07 


•300 






0300- 


99 




•>315 







OC CO OD 



030 1- B9 00 08 OA OA OA 99 
0308- 00 08 CB DO F4 AG 2B A9 
0310- 09 85 27 AD CC 03 



» 



32A 



0316- 


85 


41 






0318- 


84 


40 


8 A 


4A 4A 4A 4A 09 


D320- 


CO 


85 


3F 


A9 5D 85 3E 20 


0328- 


'H3 


03 


20 





When the Monitor performs a memory dump, it starts at the 
location immediately following the last opened location and 
displays that address and the data value stored there. It then 
displays the values of successive locations up to and including 
the location whose address you typed, but only up to eight 
values on a line. When It reaches a location whose address is a 



J 

II 

-J 
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multiple of eight— that is. one that ends with an 8 or a — it 
displays that address as the beginning of a new line, then 
continues displaying more values. 

After the Monitor has displayed the vaiue at the location whose 
address you specified in the command, it stops the memory 
dump and sets that location as both the last opened location 
and the next changeable tocatton. If the address specified on 
the input line is less than the address of the last opened 
location, the Monitor displays onty the address and value of the 
location following the last opened locatfon. 

You can combine the two commands, opening a Jocation and 
dumping memory, by simply concatenating them: type the first 
address, a period, and the second address. This combination of 
two addresses separated by a period is called a memory range. 



•300, 


32F 
















0300- 


99 


B9 


00 


03 


OA 


OA 


OA 


99 


0308- 


OD 


08 


C8 


BO 


F4 


A6 


2B 


A9 


0310- 


09 


85 


27 


AD 


CC 


03 


85 


41 


0318- 


84 


40 


8f\ 


4A 


4A 


4A 


4A 


09 


0320- 


CO 


85 


3F 


A9 


5D 


85 


3£ 


20 


0328- 


43 


03 


20 


46 


03 


AS 


3D 


4D 


•30.40 
















0030- 


AA 


00 


FF 


AA 


05 


C2 


05 


C2 


0038- 


IB 


FD 


DO 


03 


3C 


00 


40 


00 


0040- 


30 
















•E015 


.E025 















E015- 4C ED FD 

E0 1B- A9 20 C5 24 BO OC A9 SD 

E020- AO 07 20 ED FD A9 

* 

Pressing Creturn] by itself causes the Monitor to display one 
line of a memory dump; that is, a memory dump from the 
location following the last opened Eocation to the next 
multiple-ot-eight boundary. The Monitor saves the address of 
the last location displayed as both the last opened location and 
the next changeable location. 
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•5 

0005- DO 

* ( RETURN) 

DO DO 

*CRETURND 



0008- 00 00 00 00 00 00 00 00 
•32 



* [ RETURN^ 

AA 00 C2 05 C2 



* [ RETURN j 

0038- IB FD DO 03 3C 00 3F 

« 



10.3.3 Changing Memory Contents 

Section 10.3,2 showed you how to display values stored in the 
Apple lie s memory; this section shows you how to change 
these values. You can change any location in RAM; you can 
change the characteristics and treatment ot an output device by 
changing the contents ot locations assigned to it; and you can 
change a soft switch setting by referencing its set and reset 
addresses. 

Warning 

Use these commands carefully. If you change the zero-page 

tocations used by the interpreter or operating systerr} 

(Appendix B). you may lose programs or data stored in 

memory 



"J 



0032- FF ^ 



,^ 



U^ 



"J 



"J 

Changing One Byte ^J 

The previous commands keep track of the next changeable U^ 

location; these commands make use of it. In the next example, 

you open location 0, then type a colon followed by a value. ,^g 
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0000- 4C 
*:SF 

The contents of the next changeable focation have just been 
changed to the value you typed, as you can see by examining 
that locatbn: 



*0 



OODO" 5F 

« 

You can also combine opening and changing into one operation 
by typing an address followed by a colon and a value. In the 
example, you type the address again to verify the change 

*302:42 

•302 

0302' 42 

m 

When you Change the contents of a location, the value that was 
contained in that location is replaced by the new value, which 
will remain until you replace it with another value. 

Changing Consecutive Locations 

You don't have to type a separate command with an address, a 
colon ^ a value, and press (RgruHN] for each location you want to 
change. You can change the the values of up to eighty-five 
consecutive iocations at a time — or even more, if you ornit 
leading zeros from the values — by typing only the initial address 
and colon followed b'^ all the values separated by spaces; end 
with (RETURN) . The Monttor wiir store the consecutive values in 
consecutive locations, starting at the location whose address 
you typed. After it has processed the string of values, it takes 
the location following the last changed location as the next 
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changeable location. Thus, you can continue changing 
consecutive locations, without typing an address on the next 
input line, by typing another colon and nnore values. In these 
examples, you first change some locations, then examine them 
to verify the changes. 

*300 :G9 01 £0 ED FD 4C 3 

*300 

0300- 69 



' [return) 

1 20 ED FD 4G 00 03 

*10 :0 12 3 

* :1 5 B 7 

*1D, 17 

0010' 00 01 02 03 04 OS 06 07 



10,3,4 Moving Data in Memory 

You can copy a bbck of data stored in a range of memory 
locations from one area in memory to another by using the 
Monitor's MOVE command. To move a range of memory, you 
must tell the Monitor both where the data is now situated in 
memory — the source locations — and where you want the copy 
to go — the destination locations. You give this information to 
the Monitor by means of three addresses; the address of the 
first location in the destination and the addresses of the first 
and last locations in the source. You specify the starting and 
ending addresses of the source range by separating them with 
a period. You separate the destination address from the range 
addresses with a less-than character (<), which you may think 
of as an arrow pointing in the direction of the move. Finally, you 
tell the Monitor that this is a MOVE command by pressing (W). 
The format of the complete MOVE command looks like this: 



J 






[destinatian] < ;start:: . [end] (m) 
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When you type the actuat command, replace the words in 
braces with hexadecimal addresses, and omit the braces and 
spaces. Here are some examples of memory moves. First, you 
examine ttie values stored in one range of memory, then store 
several values in another range of memory. The actual MOVE 
commands end with (m) . 



'Q.F 



0000- 5F 00 05 07 00 00 DO 00 

0008- 00 00 00 00 DO 00 00 00 

♦300:A9 BD 20 ED FD A9 45 20 DA FD 4C 00 

03 

*300.30C 

0300- f\3 8D 20 ED FD fl9 AS 20 
0308- DA FD 4C 00 03 

*0<300.30CCm) 

•O.C 

OOOO- fi9 8D £0 ED FD A9 45 20 
0008- DA FD 4C 00 03 
•310<8.A(m} 

*310.312 

0310- DA FD 4C 
*2<7.9Cm] 

*a .c 

0000- A9 8D 20 DA FD f\3 45 20 

0008- Dft FD 4C 00 03 

• 

The Monitor moues a copy of the data stored in the source 
range of locations to the destination locations. The values in the 
source range are left undisturbed. The Monitor remembers the 
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last location in the source range as the Sast opened location, 
and the first location in the source range as the next 
changeable location. If the second address in the source range 
specification js less than the first, then only one value (that of 
the first location in the range) will be moved. 

See section 10,6 for an interesting If the destination address Of the MOVE cornrnand is inside the 
appiicaiiDn of this featjre source range of addresses, then strange things happen: the 

locations between the beginning of the source range and the 
destination address are treated as a sub-range and the values 
in this sub-range are replicated throughout the source range. 



I 



iO.3.5 Comparing Data in Memory J| 

You can use the VERIFY command to compare two ranges of ^S^ 

memory using the same format you use to move a range of 
memory from one place to another. In fact, the VERIFY 
command can be used immediately after a MOVE to make sure 
that the move was successful. 



^ 



The VERiFY command, like the f^OVE command, needs a y^ 

range and a destination. The syntax of the VERIFY command is: "~ 

'destination! < Istart! . lendl (T) — ^ 

II III / y^ 

The Monitor compares the values in the source locations with ■* 

the values In the locations beginning at the destination address. 

If any values don't match, the Monitor displays the address at j^^ 

which the discrepancy was found and the two values that differ. ** 

In the example, you store data values in the range of locations 

from to $D, copy them to locations starting at $300 with the ^^ 

MOVE command, and then compare them using the VERIFY ^ \ 

command. When you use the VERIFY command after you 

change the value at location 6 to SE4, It detects the change. 
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*0:D7 F2 E9 F^ F1 ES EE AO E2 F9 AO C3 C^ 

OS 

*300<0,DCm) 
•300<O.DE) 
*6:E4 

*3DO<0.D® 
0006-E4 <EE) 



Like the MOVE ccunmand, the 
VERIFY command also does 
urnLisuaf Ihings If the d-estinalion 
address is within the source range; 
see section 10,6. 



If the VERIFY command finds a drscrepancy, it displays the 
address of the location in the source range whose value difters 
from its counterpart in the destination range- If there is no 
discrepancy. VERIFY displays nothing. The VERIFY command 
leaves the values in both ranges unchanged. The last opened 
location is the last location in the source range, and the next 
changeable location is the first location in the source range, just 
as in the MOVE command. If the ending address of the range is 
less than the starting address, the values of only the first 
locations in the ranges will be compared. 



10,4 Monitor Register Commands 



Even though the actual contents of the 65C02's internal 
registers are changing as you use the Monitor, you can 
examine the values that the registers contained at the time the 
Monitor gained control, either because you called it or because 
the program you are debugging stopped at a break (BRK), You 
can also store new register values that will be used when you 
execute a program from the Monitor using the GO command. 
described below. 
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10.4.2 Examining Registers 

Pressing (contfiolx T) and then [_return ) invokes the Monitor's 
EXAMINE command, which displays the stored register values 
and sets the location containing tlie contents of tine A register 
as the next changeable location. Alter using the EXAMINE 
command, you can change the values in these locations by 
typing a colon and then typing the new values separated by 
spaces. In the following example, you display the registers, 
change the first two, and then display them again to verify the 
change- 

* C CONTROL K F) 

A=OA X-FF Y^D8 P=BO S=F8 
*tBO 02 

* ( contrqlX T) 

fl-BO X^02 y=D8 P=BO S=F8 



i 



10.4.1 Changing Registers 

When you call the Monitor, it stores the contents of the 65C02 ^ 

registers in memory. The registers are stored in the order A. X, 

Y. P (processor status register), and S (stack pointer), starting 

at location $45. When you give the Monitor a GO command, the J*^ 

Monitor loads the registers from these tive locations before it 

executes the first instruction in your program, 
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10,5 Miscellaneous Monitor Commands 



Tne COUT subroutine is described 
in Chapter 3. 



These MorJEor commands enable you to change the video 
display format from normal to inverse and back, and to assign 
input and output to external devices 



10.5. 1 Display Inverse and Normal 

You can control the setting of the inverse-normal mask location 
used by the COUT subroutine frorn the Monitor so that all the 
Monitor's output will be in inverse format. The INVERSE 
command I sets the mask such that all subsequent inputs and 
outputs are displayed in inverse format. To switch the Monitor's 
output back to normal format, use the NORMAL command N, 



^O.F 



0000- 


OA OB OC OD OE OF DO O'* 


0008- 


CG 01 FO 08 CA DO F6 PS 


*Q3 





■■,F 



0000- 


OA OB OC OD OE OF DO 04 


0008" 


C6 01 FO Oe CA DO F6 A6 


•® 





•O.F 

0000- 
0008- 



OA OB OC OD OE OF DO QA 
C6 01 FO 08 CA DO F6 A6 
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See Appendix D. 



10.5.2 Back to BASIC 






If you are using one o1 the Apple disk operating systems \^^^ 

(ProDOS or DOS), press CcqntrolK reset j or type 



to return to the language you were using, with your program 

and variables intact. 

Hole: If you type the fatter command, make sure that the 
third character you type is a z&ro. not a Setter O, The letter G 
is the Monitor's GO command, described below in 
section 10.7. 



J 

:j 

"J 

"J 



If there is no operating system in RAM, use ttie BASIC 

command fcoNrROLV Til to leave the Monitor and enter the 

BASIC interpreter that was active when you entered the 

Monitor. {Normally ttiis is Applesoft BASIC) Any program or |*^ 

variables that you had previously in BASIC will be lost. If you 

want to re-enter BASIC with your previous program and -^ 

variables intact, use the CONTINUE BASIC command ji*-* 

{ CONTROO Tcl. 
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Chapter 3 li&ts th6 Apple He port 
numbers availabEe. 



For mare information on ttie way 
those commands work, refer to 
section 3,1 , 



10.5.3 Redirecting input and Output 

The CONTROL-P command diverts all output normalty destined 
for the screen (port 0) to a device attached to one of the other 
ports, from 1 to 7. The format of the command js 

Iport number! (cqmtrqlK ^ 

A CONTROL-P command to port number will switch the 
stream of output characters back to the Apple lie s video 
display. However, use (esc] CcoNTROLl -rol if the enhanced video 
firmware is active (solid-block cursor). 

In much the same way that the CONTROL-P command switches 
the output stream, the GONTROL-K command substitutes a 
device connected to a specified port for the Apple lie s normal 
input device, the keyboard. The format for the command is: 

;port number; 



pressing ® [ control K kI directs the Monitor to accept input 
from the Apple lies buiit-in keyboard. 

The CONTROL-P and COntrOL-k commands are the exact 
equivalents of the BASIC (but not DOS and ProDOS) commands 
PR* ana IH". 



10.5,4 Hexadecimaf Arithmetic 

The Monitor will also perform one-byte hexadecimal addition 
and subtraction. Just type a line in one of these formats 
followed by (returmi) 



lvalue] + value, [return] 
]valiie| - value; [return] 

The Apple He performs the arithmetic and displays the resulL as 
shQV\rn in these examples, 

* 2 Q * 1 3 
-33 
*4A-C 
= 3E 
*FF + 4 
-03 
*3'4 
-FF 
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10,6 Special Tricks With the Monitor 



•300-307 300:18 69 1 Cn]3Q0,3G2 

0300- GO DO 00 00 00 00 00 GO 
0300- 18 69 01 






This section describes some more complex ways of using the 
Monitor commands. 



10^6. 1 Muttipte Command Lines j 

You can put as many Monitor commands on a single line as MM 

you like, as fong as you separate them with spaces and the 1 

total number of characters in the line is tess than 254, Adjacent ^_^ 

single-letter commands such as Qt CE). CD' ^^^ ® ^^^^ ^^^ W« 

be separated by spaces. *"_ 

You can freely intermix all of the commands except the ^ 

STORE (:) command. Since the Monitor takes all values C^ 

following a colon and places them In consecutive memory 

locations, the last value in a STORE must be followed by a 

letter command before another address is encountered. You 

can use the NORMAL command as the required letter command 

in such cases; It usually has no effect and can 5e used — ^ 

anywhere. C** 

In the following example, you display a range of memory, ^^ 

change it, and display it again, all with one line of commands. i^ 



g^ 






If the Monitor encounters a character in the input tine that it — jI 

does not recognize as either a hexadecimal digit or a valid fiH 
command character, it executes all the commands on the input 

line up to that character, then grinds to a halt with a noisy beep ^-*« 

and Ignores the remainder of the input line. If^ 
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10.6.2 Fitting Memory 

The MOVE commartd can be used to replicate a pattern of 
values throughout a range of memory. To do this, first store the 
pattern in the first locations in the range; 

•300: 11 22 33 



Remember the number of values in the pattern: in this case, it 
is 3- Use the number to compute addresses for the MOVE 
command, like this: 

]start+number < [start, . |end-number [W) 

This MOVE command wiEl first replicate the pattern at the 

locations immediately following the original pattern, then 
repiicate that pattern following itself, and so on until it fills the 
entire range. 

• 30 3< 30 0.3200 

•300*32F 

0300- 11 22 33 11 22 33 11 22 

0308- 33 1 1 22 33 1 1 22 33 1 1 

0310- 22 33 11 22 33 11 22 33 

0313- 1 1 22 33 11 22 33 11 22 

0320- 33 1 1 22 33 1 1 22 33 1 1 

0328- 22 33 11 22 33 11 22 33 
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You can do a similar trick with the VERIFY cornmand to check 
whether a pattern repeats itself through memory This is ^^ 

especially useful to verify tliat a given range of memory ir-^ 

locations atl contain the same value. In this example, to see the J 

VERIFY command detect the discrepancy, you first fill the «^ 

memory range from $300 to $320 with zeros and verify it, then 
change one location and verify again: 



*300:0 

*3QU300.31F[m] 

*301<300.31F(T) 

•304 :Da 

*3ai<300.31F(y] 

0303-00 (02) 
0304-02 COO) 



fO.6.3 Repeating Commands 

You can create a command line that repeats one or more 
commands over and over. You do this by beginning the part of 
the command line that you want to repeat with a letter 
command, such as ®. and ending it with the sequence 34 : n. 
where n is a hexadecimal number that specifies the position in 
the line of the command where you want to start repeating, for 
the first character in the line. n=0. The value for n must be 
followed with a space in order for the loop to work properly. 

This trick takes advantage of the fact that the Monitor uses an ~ 

index register to step through the input buffer, starting at ^ 

location S200. Each time the Monitor executes a command, it ^^ 

stores the value of the index at location $34; when that 

command is fiinished, the Monitor reloads the index register with ^^ 

the value at location S34. By making the last command change ^^^ 

the value at location S34, you change this index so that the 

Monitor picks up the next command character from an earlier ^^ 

point 'm the buffer. ^l^ 
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The only way to stop a loop fike this is to press 
tcoNTPQLK reset] ; thai is liow this escample ends. 



*® 300 302 34:0 (W) 


0300- 


11 


0302- 


33 


030 0- 


11 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


11 


0302- 


33 


0300- 


11 


0302- 


33 


030 





W.6.4 Creating Your Own Commands 

The USER command, { controlK D, forces the Monitor to jump 
to memory iocation $3F8- You can put a JMP instruction there 
that jumps !o your own machine-language program. Your 
program can then examine the IVIonitor's registers and pointers 
or the input buffer itself to obtain its data. For example, here is 
a program that displays everything on the input line after the 
( contholK Ti. The program starts at location $300; the 
command line that starts with $3F8 stores a jump to $300 at 
location S3F8. 



*300:A4 34 B9 00 02 20 ED FT) CS C9 8D DO 
F5 4C 69 FF 

*3F8:4C 00 03 



*CcONfR0L>Q THIS IB A TEST 
THIS IS A TEST 
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10.7 Machine-Language Programs 



10.7.1 Running a Program 



i 

qJ 
work directly on the bits and bytes. Yf^ 



The mam reason to program in machine language is to get 

more speed. A program in machine language can run much 

faster than the same program written in high-level languages 

such as BASIC or Pascal, but the machine-language version 

usually takes a lot longer to write. There are other reasons to 

use machine ianguage: you might want your program to do [f ^j 

something that isn't included in your high-level language, or you ' 

might just enjoy the challenge of using machine language to 



Note: If you have never used machine language before, you'll 
need to learn the 65C02 instructions listed in Appendix A. To 
become proficient at programming in machine language, 
youll have to spend some time at it. and study one of the 
books on 55C02 programming listed in the Bibliography. 

You can get a hexadecimal dump of your program or move it 

around in memory using the commands described in the 

previous sections. The Monitor commands in this section are 

intended specifically for you to use in creating, writing, and 

debugging machine-language programs. jJS 

!j 



i 



!] 



The Monitor command to start execution of your 

machine-language program is the GO command. When you type 

an address and press [g^. the Apple lie starts executing M^ 

machine-language instructions starting at the specified location. 

If you just press (^, execution starts at the last opened 

location. The Monitor treats this program as a subroutine: it 

should end with an RTS {return from subroutine) instruction to 

transfer control back to the Monitor. 



The Monitor has some special features that make it easier for 
you to write and debug machine-language programs, but before 

you get into that, here is a small machine-language program ^ 

that you can run using only the simple Monitor commands C^ 

already described- The program in the example merely displays 
the ietters A through Z\ you store it starting at location $300, 
examine it to be sure you typed it correctly, then type 30 OG to 
start it running. 
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Since programs that translate 
assembly fanguage into machine 
language are called ass&mblers, a 
program like Ihe Monitor's LIST 
commard that translates machine 
language into assembly language is 
called a disasflemblfir. 



The word mnemionic conies from 

the same root as memory and 
refers to short acronyms rhat are 
easier to remembef than the 
hexadecimal operation codes 
Ihemselwes. For estampSe, for cfear 
carry you write CLC instead 

of SI a. 



•300:A9 C1 £0 ED FD 18 69 1 C9 DB DO FS 60 

*300.30C 

0300- A9 CI 20 ED FD 18 69 01 

0308- C9 DB DO FG 60 

♦300CG) 

ABCDEFGHIJKLriNDPQRSTUVWXYZ 



iO.T.2 Disassembied Programs 

Machine-language code in hexadecimal isn't the easiest thing in 
the world to read and understand. To make this job a little 
easier, machine-language programs are usually written In 
assembly language and converted into machine-language code 
by programs called assemblers. 

The Monitors LIST command displays machine-language code 
in assembly-language form. Instead of unformatted hexadecimal 
gibberish, the LIST command displays each instruction on a 
separate line, with a three-letter instruction name, or mnemonfc, 
and a formatted hexadecimal operand. ThB LIST command also 
converts the relative addresses used in branch instructions to 
absolute addresses. 

The Monitor LIST command has the formal: 

[location [T] 
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The LIST command starts at the specified location and displays I 

as much memory as it takes to make up a screenfuli (20 lines] - _| 

of instructions, as shown in the foilowmg example: i?-^ 

•300(D ^ 



0300- 


A9 


CI 


LDfl 


#$C1 


0302- 


20 

FD 


£D 


JSR 


$FDED 


0305- 


le 




CLC 




0306- 


69 


01 


ADC 


*^$D1 


0308- 


C9 


DB 


CMP 


ff$UB 


030A- 


DO 


F6 


BNE 


$0302 


030C- 


60 




RTS 




03QD- 


00 




BRK 




030E- 


00 




BRK 




030F- 


00 




BRK 




0310- 


00 




BRK 




0311- 


00 




BRK 




0312- 


00 




BRK 




0313- 


00 




BRK 




0314- 


00 




BRK 




0315- 


OQ 




BRK 




0316- 







BRK 




0317- 


00 




BRK 





J 
-J 

-J 



^ 



tf^ 
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031Q- 



0319- 



00 



00 



BRK 



BRK 



The first seven lines of this example are the assembly-language 
form of the program you typed in the previous example. The 

rest of the lines are BRK instructions only if this part of memory 
has zeros in it: other values will be disassembled as other 
instructions. 

The Monitor saves the address that you specify in the LIST 
command, but not as the last opened location used by the other 
commands. Instead, the Monitor saves this address as the 
program counter, which it uses only to point to locations within 
programs Whenever the Monitor performs a LIST command, it 
sets the program counter to point to the location immediately 
following the last location displayed on the screen, so that if 
you type another LIST command it will display another 
screenfull of instructions, starting where the previous display 
left off. 
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Here is a summary of the Monitor commands, showing the 
syntax diagram for each one 



Examining Memory 

'adrs, [. BETURNl 

;adrs1 .:adrs2; (BETURht) 

|adrs;(T) 



Displays the value contained in one 

JDcatior. 

Displays the vafues contained in all 
locations between adrsi; and ;adrs2| 

Displays the walues In up to erght 
locations fol^lowing the Issi opened 
location. 

Lists disassembfed code starting at 
adrs: and continuing until the screen 

is Full. 
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Changing the Contents of Memory 



;lvat!'val|... 



Moving and Comparing 

|desl|<::stari;H]end|® 

|dBst]<|start|.|end'CF) 



The Register Command 



{ gPNTROL H T} 



STORE comTTiand. Stores ihe values 
■in consecutive memory locations 
starting at adrs;. 

Stores values in memory starting at 
the next changeable location. 



MOVE command- Copies the values in 
the range start,. |end Into the range 
Beginning at dest;. 

VERIFY command. Compares the 

t/aJues in the range ;start;. end; to 
tnose in the range beginning at ;desf. 



EXAMINE command. Displays the 
locations where the contents of the 
65CQ2 s registers are stored and 

opens them lor chanQing_ 



J 
J 



H- 



Misceli&neous Monitor Commands 



CD 

m 

tCt>JTFloQ - ( c) 

;val! + ;vat; 
:val -:vai: 



INVERSE coinmand. Sets inverse 
display mode. 

NORMAL command. Sets normal 
display mode- 

8ASIC command. Enters the language 
currantiy active (normally Applesort). 

CONTINUE BASIC command. Returns 
to the language currentfy active 
(normally Applesoft). 

Adds the two values and prints the 

hexadecimal resutt. 

Subtracts the second value Ircm the 
first and prints the result. 
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I port] (gowtrqlK F) 



esg) rcQhJfnoLK o^ 



|P0rt| (pOHTHOLVf'r) 



lCOWTBOL>fv1 



Redirects output 1o ihe device 
connected to port number iport;. ft 
;pon =0, sendB output to the video 
display. Use only when the entranced 
video lirmware ts not active 
(cfieckerboard cursor). 

Redirecls output to vicfeo ctispia/ 
when enhanced video firmware is 
active (solid biocK cursor) 

Takes iirpjt Irom the device 
connected to port cumber ;poft . II 
Iport] ^0. accepts input froiri the 
keyboard. 

USEfl command. Jumps to the 
mactiine-iianguage subroytine at 
location S3Fa 



Running and Listing Programs 

]adrs'CEl 
]adrs;[L] 



Transfers control to the machine 
language program beginning at jadrs;. 

Oisassembjes end displays 

20 instructions starting at |adrs". 
Subsequent (T]'s dispiay 20 more 
instructions each. 
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Most of this manual describes functions — what the Apple lie 
does This chapter, on the other hand^ descfibes objects, the 
pieces of hardware the Apple fic uses to carry out its functions, 
]f you are destgning a device to connect to the Apple lie back 
panel, or if you just want to know more about how the Apple Itc 
is buitt, you should study this chapter. 



11,1 Environmental Specifications 



^ 
^ 



The Apple He is quite sturdy when used in the way it was 
intended^— as a transportable computer, made for use in an 
indoor environment You can carry it by its handle from room to 
room, but for longer trips Apple recommends that you use its 
carrying case or some other protective container (such as an 
attache case). 

Table 11-1 defines the conditions under which the Apple lie is 
designed to function properly. 

Table ii-i. Summary of Environmental Specifications 

Operating TemperatLre: 10' to 40" C (50* to 104* F) 

Relative HLmidity: 20% to 95% 

Line Voltager 105 to 129 VAC (normal USA voltage 

range) 

You should treat the Apple He with the same kind of care as 
any other electrical appliance. You should protect ft from 
physical abuse, and be careful not to bump it against furniture 
when you move it around. Put it in an attache case or other 
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protective covering if you carry it outside. You should also 
protect the mechanical l<eyboard and the electricai connectors 
inside the case from spilled liquids. 

In normal operation (with the handle locked in its down 
position), enough air flows through the openings in the case to 
keep the insides from getting too hot. If you manage to 
overheat your Apple lie — for example, by blocking the upper or 
lower ventilation openings — the first symptom wiH be erratic 
operation, such as unexpectedly changed data. The memory 
devices in the Apple lie are especially sensitive to heat. 

Disks are another heat sensitive element of the system, if the 
built-in drive becomes too hot, a disk within can warp or even 
melt. 



A 



11.2 Power Requirements 



i 

i 

I? 
is-] 

11.2. 1 The External Power Supply [g^ 



The electrical power that the Appte lie, and everything that 
draws power from it. is limited by the tolerances of its power 
supply and internal voltage converter. This section describes 
these limits for the USA external power supply. Appendix G 
describes them for models built for other countries. The internal 
voltage converter is the same on all models. 



If you purchased your Apple lie outside the USA, consult 
Appendix G for external power supply characteristics. 



The external power supply operates on normal household AC 

power and provides DC power to the Apple lie internal 

converter. The basic specifications of the external power supply Ifi*^ 

are listed in Table 11-2. The Apple lie external power supply s 

cord must be plugged into a three-wire 115-volt (nominal) outlet 

The line voltage must be in the range given in Table 11-2, 1^*^ 



L 
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Warning 

Important Safety instructions: This product is equipped With a 

three-wire grounding-type plug — a plug having a third 
(groundir^gj pin. This plug will oniy fit into a grounding-type 
AC outlet. This is a safety feature. 

if you are unabfe to insert the plug into the outlet, contact a 
licensed eiectncian to replace the outlet and, if necessary, install 
a grounding conductor. 

Do not defeat the purpose of the grounding-type plug. 

Tabte 1t-2. Power Supply Specificatiifns 

Lire Voltage: 105 to 12& VAC, 50 Hz 

Wanfmum Input Power Consumption; 25 W 

Supply Voltage: +15 VDC (nominal) 

Supply Current: 1 2 A (nominal) 

11.2.2 The Externa! Power Connector 

The external power supply is attached to the internal converter 
by rrieans of a 7-pin DIN connector, The connector pins are 
identified in Figure 11-1 and Table 11-3. 

Figure 17-1. Extern^} Power Connector 




Pin Signal 



1 


Not cofinecled 


2,3 


Signal grd'Lind 


A 


Shii eld ground 


56 


1 15 VDC 


7 


Not connoted 
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Tabie 11-3. Extsm&f Power Connector Signals 

Pin Number Name Oescnption 

1,7 Not connected 

2^3 Ground Common electrical ground 

4 Chassis Cliassis grojnd 

53 + 1 5V +15 vqlt DC inpjt to converter 



i 

\ 

i 1.2.3 The fnternaf Converter _J 

The internal converter in the Apple He operates on from 9 to SS^ 

20 votts DC as provided by the external power supply or its 
equivalent- The internal converter provides enougli low-voltage 
electncal power for the built-in electronics plus an external disk 
drive attached via the 19-pin connector. The basic 
specifications of the imernai converter are listed in Table 11-4. 
Listed amperages are those available in addition to the current 
drawn by the Apple lie itself. Minus 5 volts is derived from the 
-12 volts provided by the voltage converter. 



Tabie 11-4. tntemai Convertai' Specifications 

Input Voltage: 

Maximum Power 

Consumption: 

Supply Voltages; 
Maximumi Supply Currents: 



+ 9 to 20VDC 




2SW 






•* 5V 


+ 5% 




-i-l2V 


^ 1 O'^'o 




-12V 


+ 10% 




+ 5V: 


1.5 A 




+ 12V: 


0.I& A continuous 
0.9 A intermittent 






1.& A surge (for --^ 


100 ms) 


^IZV: 


too mA 




(-5V: 


50 mA) 





Maximum Case Temperature: 60°C (14Q"F) 

The Apple lie uses a swJtching-type Internal voltage converter. It 
is small and lightweight, and it generates iess heat than other 
types of voltage converters do. 

The Apple lies voltage converter works by using the 

DC voitage input to power a variable-frequency oscillator. The 

oscillator drives a small transformer with severai separate 
windings to produce the different voltages required. A circuit 
compares the voltage of the +5 volt supply with a reference 
voltage and feeds an error signal back to the oscillator circuit. 
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The osciltator circuit uses the error signal to control the duty 
cycle of its oscillation and keep the output voltages in their 
normal ranges. 

The converter includes circuitry to protect itself and the other 

electronic parts of the Apple lie by limiting al! three output 
voltages whenever it detects one of the following malfunctions: 

♦ any supply voltage short-circuited to ground 

• any output voltage outside the normal range. 

Any time one of these malfunctions occurs, the protection 
circuit varies the duty cycle of the oscillalor, and all the output 
voltages drop to zero. 
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11,3 Apple lie Overali Block Diagram 



A full set of schematic diagrams of Figure 11-2 IS an overall block diagram of the Apple lie. The 

the Apple lie appears in foUowinq sections coHtajn more detailed dfaqrams of the maior 

^^'™ ''''■ parts of the machine. 

Figure H-3. Apple He Bkxk Diagram 
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m 11.4 The CMOS 65C02 Microprocessor 

The Apple lie uses a CMOS 6502 (designated as 65C02) 
microprocessor as its central pmcessing unit (CPU). The 65C02 
in the Apple He runs at a clock rate of 1.D23 MHz and performs 
up to 500.000 eight-bit operations per second. 

Note: You should not use the clock rate as a criterion for 
comparing different types of microprocessors. The 65C02 
has a simpler instruction cycle than most other 
microprocessors and it uses instruction pipelining for faster 
processing. The speed of the 65C02 wtth a 1 MHz clock is 
equivalent to many other types of microprocessors with clock 
rates up to 5 MHz. 

In addition to requiring lower power than earlier t^MOS 6502 
processors, the 65C02 in the Apple lie provides the 
These instructions are described in programmer with 27 new instructions. However, programs that 
Appendix A ygg these additional instructions will not be backward 

compatible with other Apple II series computers that are not 
equipped with a CMOS 6502. 
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11.4.1 6SC02 Block Diagram 

Figure 11-3 is a block diagram of the 65C02 microprocessor 
Table 115 contains the general specifications ot this chip 



Figure 11-3. 65C02 Bfock Diagram. Copynght 1982. NCH Corporation 
Used by permission of NCH Corporation. D&yton, Ohio. 
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The B5C02 has a sixteen-bit address bus, giving it an address 
space of 64K (two to the sixteenlh power or 65536) bytes. The 
Apple lie uses special techniques to address a total of more 
than 64K: for details, refer to Chapter 2. 
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Table 1 7-6. 65C02 Microprocessor Specittcatfans 



Type: 


B5C02 


Register Complement: 


8-bit Accumulator (A) 
8-bit Index Registers {X,Y) 
a-bit Stack Pointer {S) 
8-bit Processor Status (P) 
16-bit Pfogram Counter (PC) 


Data Bus: 


Eight bits wide 


Address Bus: 


Sixteen bits wicj@ 


Addr&ss Range: 


66,536 (64K) 


Interrupts: 


IRQ {maskable) 
NMJi (non-maskable) 
BRK (programmed) 


Operating Voltage: 


4-5V (+ 5%) 


Pawer CissipBtion: 


5 mW {at 1 MHz) 



11,4^2 65C02 Timing 

The operation of the Apple lie \% controlled by a set of 
synchronous timing signals, sometimes called clock signals, 
The frequency of the oscillator that generates the master timing 
signal is 14.318 MHz. Circuitry in the Apple lie uses this Clock 
signal, calted 14M. to produce all the other timrng signals. 
These timing signals perform two major tasks: controlling the 
computing functions, and generating the video display. The 
timing signals directly involved with the operation of the 65C02 
are described m this section. Other timing signals are 
described m sections 11.6.2, 11.9.3, and 11.9.4. 

The main 65C02 timing signals are listed in Table 11-6, and 
their relationships are diagrammed iri Figure 11-4, The 65C02 
Clock signals are -.M and ^'>0. complementary signals at a 
frequency of 10227 MHz, The Apple lie signal named «i>0 Es 
equivalent to the signal called -^2 in Appendix A (it isn't 
ident(cal^ifs a tiny bit early)_ 
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Figure 1i-4, B5CD2 Timing Stgnais 
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T9t>Se 11-6^ B5C02 Timing Signai Dsscrfptipn^ 

Signal Name Descrrptton 

14M Master oscillator, 14.318 MHz; also 80-co(umn dot clock 

VI07M imerinecliate umirig signal and 40-colijmn dot docK 

03 Inlefmediate liming signat, 2.045 MHz with asymmetrical duty 

cycle 

^ Phase o1 65C02 dock, 1 ,0227 MHz; complement oi <;i1 

)^^ Phase 1 of 65C02 clock, 1 .0227 IwlHz; complement of ^0 

The operations of the 65C02 are related to the dock signals in 
a simple way: interna) during ./jI, external during (^0. The 65C02 
puts an address on the address bus during ^^. This address is 
valid not I'ater than 110 nanoseconds after rM goes high and 
remains valid through all of «^jO. The 65C02 reads or writes data 
during i>Q. If the 65C02 is writing, the read/write signal is low 
during <A0 and the 65C02 puts data on the data bus. The data is 
vaiid not later than 75 nanoseconds after <iiQ goes high. If the 
65C02 is reading, the read/write signal remains high. Data on 
the data bus must be valid no later than 50 nanoseconds before 
the end of 4>^. 
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Most of the circuitry that controls memory and I/O addressing in 
the Apple lie is in five custom integrated circuits 

• the Memory Management Unit (MMU) 

• the Input-Output Unit (lOU) 

• the Timing Generator (TMG) 

• the General Logic Unit (GLU) 

■ the Disk Controller Unit (IWM) 

The soft switches used for controlling the various I/O and 
addressing modes of the Apple lie are addressable flags inside 
the MMU, SOU. and GLU. The functions of the MMU and lOU 
are not as independent as their names suggest; working 
together, they generate all of the addressing signats. For 
example, the MMU generates the RAM address signals for the 
CPU, while the lOU generates similar RAM address signals for 
the video display and most I/O hardware addresses. 
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Note: A Signal name followed by an asterisk is active low, 
that is. it is true when not asserted. 



4 



1 1,5. 1 The Memory Management Unit (MMU) 

The circuitry inside the MMU implements these soft switches, 
which are described in the following chapters: 

• Page 2 display (PAGE2): Chapter 5 

• High-resolution mode (HIRES): Chapter 5 

• Store to 80-Golumn display (80STORE): Chapter 5 ^ 

• Select bank 2 {BANK2): Chapter 2 

• Enable bank-switched RAM (ENLCRAM): Chapter 2 gjj 

• Read auxiliary memory (RAMRD): Chapter 2 

• Write auxiliary memory (RAMWRT); Chapter 2 ^y 

• Auxiliary stack and zero page (ALTZP): Chapter 2 

• Reset mouse Y interrupt (RSTYINT); Chapter 9 ^ 

• Reset mouse X interrupt (RSTXINT): Chapter 9 

These switches are available on MMU pin 21, which is fl^ 

connected to bit 7 on the data bus. Figure 11-5 shows the ^" 

MMU pinouts; Table 11-7 describes the signals. 



p 



lil^ 



The 64K dynamic RAMs used in the Apple He use a multiplexed 

address, as described below in the section Dynamic-RAM ^ 

Timing (in section 11.6.2). The MMU generates this multiplexed j^ 

address for memory reading and writing by the 65C02 CPU. ■• 

Mr 
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Figure IJ-S. The MMU PsnouSS 
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RA5 
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29 
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2B 
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A1 


Pin Number 


Name 


A2 


1 


GND 


A3 
A4 


2 


AO 


AS 
A6 
A7 


3 

A 


^0 
03 


A8 
A9 


5 


PRAS' 


A10 


6-13 


RA0-HA7 


All 
A12 


14 


R/W 


A13 

A14 


15 


INH' 


A15 

+ 5V 


1G 


cosx* 


SELIO* 






CASEN' 

C07X' 

MD7 


17 
18 


ENaO' 

KBO' 




19 


R0MEN2' 




20 


ROMENr 




21 


MD7 




22 


ca7x 




23 


CASEW 




24 


SEUO- 




25 


+ SV 




26-40 


A15-A1 



Description 

Power and signal common 

G5C02 address input 

Clock phase Q input 

Timing signal inpul 

Memory row-address strobe 

Multiplexed address output 

@5C02 read-write control signs! 

Jnliibits main memory (tied 
to i 5 V) 

Causes SCOe* outputs to go to 
during !,•^0 

Enables auxiliary RAM 

Enables keyl^aard data bits Q-6 

Enables ROM ^tied to ROMENl*) 

EnatJiBs ROM (tied to R0WEN2-) 

Slate ot MMU flags on daia bus 
bit 7 

Causes $CQ7x: outputs to go to 
during -i^O 

Enables main RAM 

Goes to during (,'jO for any access 
to SCO page except SCOSx, Bm, Ck 
or Fx 

Powef 

65C02 address input 
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Figure If 6, ffle fOU Pinoats 
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t1S.2 The input/Output Unit (fOU) 

The circuitry inside the Input/Output Unit (lOU) Implements the 
following soft switches, ail described in Chapters 2 and 3: 

• Page 2 display (PAGE2) 

• High-resolution mode (HIRES) 

• Text mode (TEXT) 

• Mixed mode (MIXED) 

• SO-column display (80COL) 

• Character-set select (ALTCHAR) 

• Any-key-down (AKD) 

• Mouse movement (XO, YO) 

• Vertical blanking interrupt (VBLINT) 

These switches are available on lOU pin 9, which is connected 
to bit 7 on the data bus. Figure 11-6 shows the MMU pinouts; 
Table 11-B describes the signals. 

The 64K dynamic RAMs used in the Apple lie require a 
muitiplexed address, as described in the section Dynamic-RAM 
Timing {\w section 11.6,2). The iOU generates this multiplexed 
address for the data transfers required for display and memory 
refresh during clock phase 1. The way this address is 
generated is described in section 11.9.1. 



Tsble 1 t'S. The tOU S/gnal Descriptions 



Pin Number 

1 
2 

3 



Name 

GND 
GR 

SEGA 

SEGB 
VC 



Description 

Power and signal common 

Graphics mode enaDie 

In leKt mode, works with VC (s&e 
pin 5) and SEGB to determine 
character row address 

In text mgde, works with VC (see 
pin 5) and SEGA; in graphics 
mode, selects high-resoiution. when 
low, low-resolution when higli 

Display vertical countST bit; in text 
mode, SEGA. SEGB and VC 
determine which cr the eight rows 
of a character's Oot pattern to 
display: in low-resolution, selects 
upper or lower block defi^ned by a 
byte 
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■J 
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Cofttiftued. The iOU Signaf Descriptfons 


Pin Number 


Name 


Description 


6 


aocoL* 


eo-column vjd90 enable 


7 


CASSO 


Reserved 


8 


SPKR 


Speaker output signal 


9 


M07 


Internal lOU flags for deia fius 

{bit 7} 


10 


YWOVE 


Det&cis mDufie movertient along 


11 


N.C. 


Not u&ed 


12 


N.C. 


Not used 


13 


PDLO/XMOVE 


□etecis mouse movement along 

X axis 


14 


R/W 


65C02 read-write contrgl signsil 


15 


RESET- 


Power on and reset output 


16 


IRQ* 


Maskable interrupt fine to 65CQ2 


17-24 


RACI-RA7 


Video refresh multiplexed RAM 
address (phase 1) 


25 


PRAS' 


Row-address srobe (phase 0| 


26 


im 


h^aster clock phase 


27 


03 


Intermediate timing signal 


28 


+5V 


Power 


29 


A6 


AOdress bit 6 from 65C02 


30 


lOUSELIO" 


Deriued from the SELIO" output fof 

MMU pm 24 


31 


AKO 


Any-key-down signal 


32 


KSTRB 


Keyboard strobe signal 


33.34 


VIDD7,VOD5 


Video display data bits 


35.36 


RA9".RA10' 


Video display conlrol bits 


37 


CLRQAT- 


Color-burst gate (enabie) 


38 


WNDW 


D'isplsy blanking signal 


39 


SVJMC* 


Display synchronization signal 


40 


HO 


Display horizoriitai timing signal 
(low bit of character counter) 
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Figure 11-7. The TMG Pinouts 
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KJ 


20 


7M 


2 




19 


CREF 


3 




IS 


HO 


4 




17 


VIDD7 


5 




16 


SEGB 


6 




15 


TEST 


7 




14 


CASEN" 


8 




13 


80GOL* 


9 




12 


Gf^D 


10 




11 



11.5.3 The Timing Generator (TMG) 

A custom timing generator chip (TIVIG) generates several timing 
and control signals in the Apple fic. The TMG pinouts are 
shown in Figure 11-7; the Signals are listed in Table 11-9. 



Tatte 11-9. The TM3 Signal Descriptions 



1 5V 


Pin Numtier 


Name 


PRAS' 


1 


14M 


(N.C.f 






PCAS^ 
Q3 


2 


7M 


^t■0 


3 


CREF 


■t1 






VID7M 
LDPS- 


A 


HO 


TMGEN' 


5 


VIDD7 




6 


SEGB 




7 


TEXT 




e 


CASEN- 







80COL- 




10 


GND 




11 


TMGEM* 




12 


LDPS' 




13 


VID7IVI 




14 


^ft1 




15 


jiO 




1$ 


Q3 




17 


PCAS" 




18 


w.c. 




19 
SO 


PRAS' 
f 5V 



Description 

14.31B MHz master timing signal 

input 

7.159 MHz trming signal 

3.5795 MHz color reference timing 
signal 

Horizontal video timing signal 

Video data bit 7 
Video timing signal 

Video display text-modes enable 
RAM enable (CAS enable) 
Enable SD-CDlumn display mode 
Power and signal common 
Enable master timing 
Video shift-register load enable 

Video dot clock eraDfe, 7 MHz or 

oontinuous 

Pliase 1 system cioc-lt 

Phase system clock 

Intermediate liming and strobe 
signal 

RAM cdumn-address strobe 

Reserved tor testing 

RAM row-address strobe 

Power 
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11.5.4 The General Logic Unit (GLU) 

The General Logic Unit is a single-chip version of the 
miscellaneous logic required for the system. It provides all RAM 
read/write timing, double-high-resolulion enable/disable, soft 
switch status registers and write command registers, it also 
provides lOU control for mouse interrupts and 
double-high-resolution soft-switches. Its pin assignments are 
shown in Figure 11-8 and its signals are Hsted in Table 11-10. 
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Figure 1 

14M 


IS. 


Tfje GLU Pi 


nauts 

+ 5V 


Table 11- to. 
Pin Number 


The GLU Signat Descriptions 
Name 




1 


w ,, 


Description 


1^ 


An 

A3 
A4 

AS 


2 
3 
4 
5 

■S 


23 

21 

20 
1& 


SER- 

(M.CJ 

DISK' 

7M 

CREF 


1 
2.3-7 


14M 
A0,A3-A7 


Master clock {14.318 MHz) 

Address lines, lo select leasJ 

significant byte of addresses on 
CD page 


1 i 

i: 


A7 

*a 

SELIO- 

GR 

RESET- 


7 
8 

TO 
11 


18 
17 
16 

15 
14 


tM.G.) 
TEXT 

Ryw' 

D7 


8 

9 


PHD 
SELIO' 


Phase □ of 1.0227 MHz processor 
sync clock 

Device select for selecting most 

significani byte oi the address 


1 -- 


GND 


12 


13 


GLUEN' 


10 
11 


GR 
RESET* 


Graphics mode select line 






Master reset for system; resets 
GLU 


L. 










12 


GMD 


Ground reference and negative 
supply 


1 - 










13 


GLUEN' 


Enables GLU 


L, 










14 


MD7 


Indicates status of MMli flags on 

data bus bit 7 


U 










15 


r;w 


Read/write qualifier inpul from 
processor 


- 










16 


TEXT 


Signal used to generate video 
timmg in doubJe-liigh-resolutlar or 

not-graphtcs 


■ J. 










17,-fe 


W.C- 


Not used 


1 










19 


CREF 


Color reference signal 


ln^^ 










£0 


7M 


7 MHe cIoc^! output 












21 
22 


DISK' 
(OUHOLE 


Disk conirolier dewlce select output 
Controls fOUSELIO 


L' 










23 


SER* 


Seriat controller device select 
output 


i J 










24 


Vcc 


4-5 volt supply 


L 

















1 1 .5 The Custom Integrated Circuits 



f22l" 



For further information on group 
code recording, refer to 
section 11-10- 



f1.5.5 The Disk Controller Unit (fWM) 

The IWM is an integrated GCR (group code recording) disk 
drive controller in its state right after reset- in addition, it has a 
status register, mode register, and multiple operating modes. It 
provides both synchronous and asynchronous modes, and a 
fast mode with a data rate twice tliat of normal disk I/O speeds. 
Figure 11-9 shows the tWM pin assignments; Table 11-11 
describes the IWM signals. 



Figure 11-9. The tWM Pinouts 



T&ms 11-11. The IWM Stgna! Descriptions 



SEEKPHO 


1 '^ 


^^^=" 
2B 


SEEKPH1 


Pin Number 


Name 


SEEKPHS 


2 


11 


SEEKPM3 


1 


SEEKPHO 


AO 


3 


26 


f5V 






A1 


4 


2S 


03 






A2 
A3 


5 

S 


24 

23 


7M 

RESET' 


2 


.SEEKPH2 


DISK* 


7 


22 


ROD ATA 


3 


AO 


WRDATA 


a 


21 


WRPROT 






WRPEQ- 


9 
10 


20 

19 


DRI- 
DR2* 


4-6 


A1-A3 


Dl 


11 


IS 


D7 






D2 
D3 


12 
13 


17 
IS 


D5 


7 


DSSK' 


GND 


14 


55 


D4 







10 13 

14 

15-1B 

\% 
20 

21 



WRDATA 



WRREQ' 



D0-D3 



GND 



a4-D7 



DescriptiGfi 

Stepper motor corlrot phase 0. 
Ore of tour programmable disk 
drive motor phase outputs. 

Stepper motor control pliase 2 

The data input to trie stale bit 

selected Dy At to A3 

These three inputs select one of 
the eight bits In ttie slate register 
to be updated- 

Device enable. The falling edge of 
DISK* latcties information 
on A1 -A3. Ttie rising edge of 
eSther 03 or DISK" qualifies write 

regi&ter data. 

Ttie serial daia ouiput- Each 1-Dil 
causes a transition on ttiis output- 

This signal is a programmable 
buffered output line. 

DO-07 make up the bidirectional 
data bus. 

Ground reference and negative 

supply 

The remaining bits ol the 
bidirectional data bus 



DR2- 


Drive 2 select 


DRI* 


Drive 1 select 


WHPROT 


Wrile-protect inpjt; this can be 
polled via Bit / of the status 
registei". 



i 






m^ 
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Tabte 7 1-1 J— Continued. The iWM Sigrtat Descriptions 



Pin Number 


Name 


Description 


22 


RDDATA 


Serial data input line. The fWM 
synchronizes the faHing transition, 
of each pulse- 


23 


RESET- 


JWM resei: places all IWM outputs 
in their inactive state and sets a\\ 
stable and mode register bits to 


24 


7M 


1 MHz dock input 


25 


Q3 


A 2-0 MHz dock input used to 
qiiality the timing o\ the serial data 
being written or read. 


26 


Vce 


The +5 volt supply 


27 


SEEKPH3 


Stepper motor contfol phase 3 


2B 


SEEKPH1 


Stepper motor contfol phase 1 



/ 1.B Memory Addressing 



The 65C02 microprocessor can address 65.536 locations. The 
Apple Jlc uses this entire address space, and then some: some 
areas in memory are used for more than one function. The 
following sections describe the memory devices used in the 
Apple lie and the way they are addressed. Input and output 
also use portions of tine memory address space; refer to 
Chapter 2 for information. 
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Figure 11-10 illustrates the overall memory bus organUation and 
memory selection signals. 



Figure 1^-10. Memory Bus Orgsntiation 
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Note: Some Apple lie's have ROMs with 27xx designations, 
some have 23xx. They are functionally equivalent. 



11.6.i ROM Addressing 

In the Apple lie the following programs are permanently stored 
in a type 23128 16K by 8-&it ROM (Figure 1111). 

• Applesoft editor and Interpreter 

• Monitor 

• Enhanced video firmware. 
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Ffgure li-lt The 23128 ROM 

Pinouts 




E 

E 
E 

E 




Figure 11-12. The 2316 ROM 

Pfnouts 




Figure 11-13, 7/je 2364 ROM 
Pinouts 



+ 5V 
+ 5V 
■I-5V 
A8 
A9 
A11 
GND 
AID 

WNDW* 
07 
06 
05 
04 
03 



1 5V 


, ^ 


23 


A12 


2 


27 


A7 


a 


26 


A6 


4 


25 


A5 


5 


2^ 


A4 


6 


22, 


A3 


7 


22 


A2 


a 


21 


A1 


9 


20 


AO 


10 


T9 


OO 


11 


18 


01 


12 


17 


02 


13 


16 


GND 


14 


15 



The ROM is enabled by two signals called ROMENI ar>d 
R0MEN2. (In the Apple He, R0MEN1 and R0MEN2 are 
electrically connected) The segment of the ROM enabled by 
R0MEN1 occupies the memory address Space from SCIOO 
to SDFFF. The address space from SC300 to $C3FF and much 
of $C800 to SCFFF contains the enhanced video firmware. 

These ROM address allocations are approximately true (some 
space sharing takes place): 

• ROM addresses $C000 to SCOFF are never available. 

• ROM addresses $C100 and SC200 are entry points to 
firmware for serial ports 1 and 2, respectively, 

• ROM address SC400 is entry point to mouse interface 
support. 

• ROM addresses $C500 to SC5FF are reserved. 

• ROM address SG600 is entry point to firmware for the 
buflt-in and external disk drives. The built-in drive is 
considered slot 6 drive 1 or its equivalent. The external drive 
js considered slot 6 dnve 2. 

• ROM addresses starting at SC700 support {from the Monitor) 
the external dnve as If it were slot 7 drive 1, for 
external-drive startup only. 

Addresses SDOOO to $F7FF contain the Applesoft BASIC 
interpreter; addresses $FSOO through $FFFF contain the Monitor 
firmware^ 

The other ROMs in the Apple lie are a type 2316 ROM 
(Figure 11-12) used for the keyboard character decoder, and a 
type 2364 ROM (Figure 11-13) used for character sets for the 
video display. This 2364 ROM is rather large because it 
includes a section of straight-through bit-mapping for the 
graphics modes. This way, graphics display video can pass 
through The same circuits as text without additional switching 
circuitry. 
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1 1.6.2 RAM Addressing j 

The RAM (programmable) memory in the Apple lie is used both ^1^ 

for program and data storage and for the video display The 

areas in RAM that are used for the display are accessed both ,^tf 

by the S5C02 microprocessor and by the video display circuits. JJ^ 

In some computers, this dual access results in addressing 

conflicts (cyde stealing) that can cause temporary dropouts in — ^ 

the video display. This problem does not occitr in the Apple lie, fef* 

thanks to the way the microprocessor and the video circuits 

share the memory. ^^^ 

The memory circuits in the Apple lie lake advantage of the "^ 

two-phase system clock described in section 11,4.2 to ^^ 

interleave the microprocessor memory accesses and the display j_:^ 

memory accesses so that they never interfere with each other. *^ 
The microprocessor reads or writes to RAM only during (/jO. and 
the display circuits read data only during r/jl. 

Dyi%amic-RAM Refreshment ^^ 

The image on a video display is not permanent; ft fades rapidly ti^ 
and must be refreshed periodically. To refresh the video display, 
the Apple lie reads the data in the active display page and 
sends it to the display. To prevent visible flicker in the display, 
and to conform to standard practice for broadcast video, the 
Apple lie refreshes the display sixty times per second. 

The dynamic RAM devices used in the Apple lie also need a 

kind of refreshment, because the data is stored in the form of ^^ 

electric charges which diminish with time and must be h^^ 

replenished every so often. The Apple lie is designed so that ** 

refreshing the display also refreshes the dynamic RAMs, The ^ 

next few paragraphs explain how this is done. j|ui 

The job of refreshing the dynamic RAIVI devices is minimized by 

the structure of the devices themselves. The Individual data ---* 

cells in each RAM device are arranged rn a rectangular array of ZT^ 

rows and columns. When the device is addressed, the part of i 

the address that specifies a row is presented first, followed by f-^ 

the address of the column. Spiitting information into parts that fct^ 

follow each other in time is called multiplexing. Since oniy half 

of the address is needed at one time, multiplexing the address .^^ 

reduces the number of pins needed for connecting the RAMs S*^ 

(Figure 11-14). 
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FigufB 11-14. The 64K RAM 

Pinouts 
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RA1 

RA4 

RA3 

RA2 

RAO 



4 5V 


1. 


^ 1S 


MDx 


2 


15 


R/W 


3 


14 


RAS^ 


4 


13 


RA7 


5 


12 


RA5 


6 


11 


RA6 


7 


10 


+ 5V 


S 


9 



Different manufacturers' 64K RAMs have cell arrays of either 
126 rows by 512 columns or 256 rows by 256 columns Only 
the row portion of the address Is used in refreshing the RAlVls. 

Now consider how the display is refreshed. As deschbed in 
section 11.9.1. the display circuitry generates a sequence of 
8,192 memory addresses in high-resolution mode; in text and 
low- re solution modes, this sequence is the 1.024 display-page 
addresses repeated eight times. The display address cycles 
through this sequence 60 times a second, or once every 
17 milliseconds, The way the low-order address lines are 
assigned to the RAMs, the row address cycles through all 
256 possible values once every two milliseconds (see 
Table 11-12). This more than satisfies the refresh requirements 
of the dynamic RAfvls. 

Tsbie 11-12. RAM Address MMtpfexing 



Mux'd Aitdress 


Row Address 


Column 
Address 


RAO 


AO 


A9 


RA1 


A1 


A6 


RA2 


A2 


A10 


FiAa 


A3 


Atl 


RA4 


A4 


A12 


RA5 


A5 


A13 


RAQ 


A7 


A14 


RA7 


AS 


A15 



Dynamic-RAM Timing 



The Apple lie s microprocessor clock runs at a speed of 
1.023 MHz, but the interleaving of CPU and display cycles 
means that the RAM is being accessed at a 2 MHz rate, or a 
cycle time of just under 500 nanoseconds. Data for the CPU is 
strobed by the falling edge of ^pQ, and display data is strobed 
by the tailing edge of iiA, as shown in Figure 11-15. 
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Figure tl-tS. RAM Timing Signals 
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The RAM timing looks complicated because the RAM address 
is multiplexed, as described in the previous section. The MMU 
takes care of multiplexing the address for the CPU cycle, and 
the lOU performs the same function for the display cycte. The 
multiplexed address is sent to the RAM ICs over the lines 
labeled RA0-RA7 (Table 11-13). Along with the Other liming 
signals, the TMG generates two signals that control the RAM 
addressing: row-address strobe (RAS) and column-address 
strobe (CAS). 
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TB&te ir-is. RAM Timing Signals 



Signal 
Name 


Description 


^ 


CiocK phase {CPU phase) 


^1 


dock phasg 1 (display phase] 


RAS 


Row-address strobe 


CAS 


Column-address strobe 


03 


Allernate RAM/Column-address stro-be 


RA0-RA7 


Mult^plexBd address bus 


MD0-WD7 


Interiral data bus 



11.7 The Keyboard 



The Apple lie's keyboard is a matrU of keyswitches connected 
to an AV-3600-type keyboard decoder via a ribbon cable and a 
26-pin connector (Figure 11-16). The AY-3600 scans the array 
of keys over and over to detect any keys pressed, The 
scanning rate is set by the external resistor- capacitor network 
made up of C46 and R6. The debounce time is also set 
externally, by C45. 

The AY-3600' s outputs include five bits of key code plus 
separate lines tor CONTROL, SHIFT, any-key-down, and 
keyboard strobe. The any-key-down and keyboard-strobe lines 
are connected to the lOU. which addresses them as soft 
switches. The key-code line, along with CONTROL and SHIFT, 
are inputs to a separate 2316 ROM, The ROM translates them 
to the character codes that are enabled onto the data bus by 
signals named KBD* and ENKBD\ The KBO' signal is enabled 
by the MMU whenever a program reads location $C0O0, as 
described in Chapter 2. 
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Figure 71- W. KeydoaM Circuit Diagram 
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Figure 11-17 illustrates the events that occur when a key is 
pressed, when the keypress fs detected by a program, and 
when a key fs pressed and held for more than about a second. 



Figure T1 17. Keyboard Signafs 

Kev 

pressed 



Key 
released 



Keyboard strobe 
tolOU 



Latched KSTRB 
fram lOU on SCCOx- 

bit7 



AKDatSCOlx 
bit 7 



I 



DecodeofSCOIxfnIOU 

clears keyboard strobe 

^bl17at$C00x) 



Another key 
pressed 



II fOU sees AKD loo fongn 

11 generates own strobe 

for auto-repeat 



Jl 



> o.a to 1.07 
— seconds - — *J 



1 1 .7 The Keyboard 



1231 



11.8 The Speaker 



AUD & an audio-amp)iflier hybrid 
qircu'lt. 



The Apple lies built-in loudspeaker is controtled by a single btt 
of output from the Input/OuTput Unit (lOU), amplified by a liybrid 
circuit (Figure 11-18). 

Figure 11-16. Spssker Circuit Diagram 
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11.8.1 Volume Control 

There is a 50D-ohm variable resistor feeding anywhere from 
to 5 volts to pin 5 of AUD to control the speaker volume. This 
potentiometer controls the volume of both the built-in speaker 
and whatever is plugged into the output jack. 



11.S.2 Output Jack 

Next fo the volume control, along the lower-left side of the 
Apple lie case, there is a 3,5 mm stereo miniphone jack. 

Although speaker output is monaural, the jack accommodates 
stereo headphone pJugs (as well as monaural, of course), 
providing sound to both channels. Inserting a headphone plug 
disconnects the internal Apple lie speaker. 
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11.9 The Video Display 






The Apple lie produces a video signal that creates a display on 
a standard video monitor or, if you add an RF modulator, on a 
black and-white or color television set. The video signal is a 
composite made up o1 the data that is being displayed plus the 
horizontal and vertical synchronization signals that the video 
monitor uses to arrange the lines of display data on the screen. 

Note: Apple lie computers manufactured for sale in the USA 
generate a video signal that is compatible with tlie standards 
set by the NTSC {National Television Standards Committee), 
Apple lies used in European countries require an external 
adapter to provide video that is compatible with the standard 
used there, which is called PAL (for phase alternating iines). 
This manual describes only the NTSC version of the video 
circuits. 

The display portion of the video signal is a time-varying voltage 
generated from a stream of data bits, where a 1 corresponds to 
a voitage that generates a bright dot, and a to a dark dot. The 
display bit stream is generated in bursts that correspond to the 
horizontal lines of dots on the video screen. The signal named 
WMDW* is \ow during these bursts. 

During the time intervals between bursts of data, nothing is 
displayed on the screen. During these intervals, called the 
blanking intervals, the display is blank and the WNDW* signal 
is high. The synchronization signals, called sync for short, are 
produced by making ttie signal named SYNC* low during 
portions of the blanking intervals. The sync pulses are at a 
voltage equivalent to blacker-than-black video and don't show 
on the screen. 

11.9.1 The Video Counters 

The address and timing signals that control the generation of 
the video display are all derived fromi a chain of counters inside 
the iOU. Only a few ot these counter signals are accessible 
from outside the IOU, but they are all Important in 
understanding the operation of the display generation process, 
particutarly the display memory addressing described in the 
next section. 
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The horizontal counter is made up of seven stages: HO, HI, 
H2, H3, H4, H5. and HPE\ The input to the horizontal counter 
is the 1 MHz signal that controls the reading of data being t^ 

displayed. The compiete cycle of the horizontai counter consists J 

of 65 states. The six bits HO through H5 count normaliy from ^^ 
to 64, then start over at 0. Whenever ttiis happens, HPE" forces 
another count with HO through H5 held at zero, thus extending 
the total count to 65. 



ej 
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The lOU uses the forty horizontal count values from 25 
through 64 in generating the low-order part of the display data 
address, as described in section 11.9.3. The lOU uses the count ^LM 
vaiues from to 24 to generate the horizontal blanking, the 
horizontai sync pulse, and the color-burst gate. 

When the horizontal count gets to 65, it signals the end of a line 
by triggering the vertical counter. The vertical counter has nine 
stages: VA, VB, VC. VO. VI. V2, V3, V4, and V5. When the gj 

vertical count reaches 262, the \0U resets it and starts counting B* 
again from zero. Only the first 192 scanning lines are actually 
displayed; the lOU uses the vertical counts from 192 to 262 to ^J 
generate the vertical blanking and sync pulse- Nothing is WSt 

displayed during the vertical blanking interval. (The vertical line 
count is 262 rather than the standard 262.5 because, unlike g^ 

normal television, the Apple lie s video display is not interlaced.) ^m^ 



1 1.9.2 Display Memory Addressing ftf^ 

As described in section 5 7, data bytes are not stored in 

memory in the same sequence in which they appear on the ^J 

display. You can get an idea of the way the display data is — 

stored by using the Monitor to set the display to graphics 

mode, then storing data starting at the beginning of the display gjj 

page at hexadecimal £400 and watching the effect on the *» 

display- if you do this, you should use the graphics display 

instead of text to avoid confusion: the text display is also used g1^ 

for Monitor input and output. "^ 

If you want your program to display data by storing it directly ^^^ 

into the display memory, you must first transform the display jU^ 
coordinates into the appropriate memory addresses, as shown 

in Chapter 2, The descriptions that follow will help you ^^ 

understand how this address transformation is done and why it ftU 
is necessary, 
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The address transformation That folds three rows of forty 
display bytes into 128 contiguous memory locations is the same 
for all display modes, so it is described first. The differences 
among the different display modes are described in 
section 11.9.4. 



THe requifernemts ior RAM 
refreshing are dtscusssd m 
sectJon 11.62. 



11.9.3 Display Address Mapping 

Consider the simplest display on the Apple lie, tfie 40-colLimn 
text mode. To address forty columns requires six bits, and to 
address twenty-four rows requires another five bits, for a total 
of eleven address bits. Addressing the display this way would 
involve 2048 (two to the eleventh power) bytes of memory to 
display a mere 960 characters. The SO-column text mode would 
require 4096 bytes to display 1920 characters. The leftover 
chunks of memory that v^/ere not displayed could be used for 
storing othef data, but not easify» because they wouW not be 
contiguous. 

Instead of using the horizontal and verticaf counts to address 
memory directly, the circuitry inside the lOU transforms them 
into the new address signals described below. The transformed 
display address must meet the following criteria: 

• Map the 960 bytes of 40-coJumn text into only 1024 bytes 

• Scan the low-order address to refresh the dynamic RAMs 

• Continue to refresh the RAfVis during video blanking. 

The transformation involves only horizontal counts H3. H4, 
and H5. and vertical counts V3 and V4, Vertical count bits 
VA, VB, and VC address the lines making up the characters, 
and are not involved in the address transformation. The 
remaining low-order count bits. HO. H1, H2. VO. V1. and V2 are 
used dfrectly. and are not involved in the transformation. 

The lOU performs an addition that reduces the five significant 
count bits to four new signals called SO, Si. 82. and S3, where 
S stands for sum Figure 11-19 is a diagram: showing the 
addition in binary form, with V3 appearing as the carry in and 
H5 appearing as its complement H5\ A constant value of one 
appears as the low-order bit of the addend. The carry bit 
generated with the sum is not used. 
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Figure ir-19r Display Address Transformation 

V3 Carry in 

H5' V3 Hi4 H3 Augend 

V4 H5' V4 1 Addend 



S3 S2 St SO Sum 



If this transformation seems t&rribly obscure, try it with actual 
values. For example, for the upper-left corner of the display, 
the vertical count is zero and the horizontal count is 24: 
HO. H1, H2. and H5 are zeroes, and H3 and H4 are ones. The 
value of the sum is zero, so the memory location for the first 
character on the display is the first location in the display page, 
as you might expect, 

Horizontal bits HO, Ht, and H2 and sum bits SO, SI, and S2 
make up the transformed horizontal address {AO through A6 in 
Table 11-14). As the horizontal count increases from 24 to 53. 
the value of the sum {S3 S2 Si SO) increases from zero to four 
and the transformed address goes from to 39, relative to the 
beginning of the display page. 

The low-order three bits of the vertical row counter are VO, V1 , 
and V2, These bits control address bits A7, A8, and A9. as 
shown in Table 11-14, so that rows through 7 start on 
I28'byte boundahes. When the vertical row counter reaches 8. 
VO, VI, and \f2 are zero again, and V3 changes to one. If you 
do the addition in Figure 11-19 with H equal to 24 (the 
horizontal count for the first column displayed) and V equal 
to 8, the sum is 5 and the horizontal address is 40: the first 
character in row 8 is stored in the memory location 40 bytes 
from the beginning of the display page. 
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Figvfe 11-20, 4V-Cctumn Texf Disptay Memory. Memory locations marked with a 
<^Oii!^ie asterisk ("} sre screen holes, cJcscnb&c/ in section 2.5. '. 
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Rgure 11-20 shows how groups of three forty-character rows 
are stored in blocks of 120 contiguous bytes starting on 
128-byte address boundaries. This diagram is another way of 
describing the display mapping shown in Figure 5-5, Notice that 
the three rows in each block of 120 bytes are not adjacent on 
the display. 
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Address bits mari^ed witti double 
asterisks (") are different for 
different modes; see Table 11-15 
and section 11,9.4, 



Table U-14. Display Memory Addressing. "For \hese address drts. see text ana 
Tabte 11-15. 



Memory 
Address Bit 


DfspEav 
Address Bit 


AD 


HO 


A1 


HI 


A2 


H2 


A3 


SO 


A4 


SI 


A5 


S2 


A6 


S3 


A7 


Vfl 


AS 


VI 


A9 


va 


A10 


" 


All 


•• 


MZ 


tt* 


A13 


» 


A14 


*p 


A15 


GND 



Tabfe 11-14 shows how the signals from the video counters are 
assigned to the address lines. HO, HI, and H2 are 
horizontal-count bits> and VO, VI, and V2 are vertical-count bits. 
SO, SI. S2 and S3 are the folded address bits described above. 

Table 11-15. Memory Address Bits for Display Modes. { . means fogicai AND: 
mear^s foglcat NOT.} 



Address Bit 

AID 

All 

A12 

A13 

A14 



Text and 
Low-Resotution 

BOSTORE + PAGE2' 

eOSTORE'-PAGE2 









DJspJay Modes 



High-ResDlution and 
Double-Higih-ResDiutiDn 

VA 
VB 



3DSTORE-PAGE2 

80STORE-.PAGE2 
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11.9.4 Video Display Modes 

The different display modes ail use ttie address-mapping 
scheme described in section 11.9.3, but they use 
different-si ^ed memory areas in different locations. 
Section 11.9.4 describes the addressing schemes and the 
methods of generating the actual video signals tor the different 
display modes. Figure 11-21 illustrates the video display 
circuits discussed in this section. 
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Figure 11-21. ViiSeo Dispiay Circuits 
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Text Display s 

The text and low- resolution graphics pages begin at meniory 
locations $400 and $800. Table 11-15 shows how the 
display-mode signals control the address bits to produce these 
addresses. Address bits A10 and All are controlled by the 
settings of PAGE2 and BOSTORE, the display-page and 
BO-column-video soft switches. Address bits A12, A13, and A14 
are set to zero, Notice that SOSTORE active inhibits PAGE2: 
there is only one display page in SO-column mode. 

The low-order six bits of each data byte reach the character 
generator directly, via the video data bus V1D0-VID5. The two 
liigh-order bits are modified by the lOU to select between the 
primary and alternate character sets and are sent to the 
character generator on lines RA9 and RA10. 

The data for each row of characters are read eight times, once 
for each of the eight lines of dots making up the row of 
characters. The data bits are sent to the character generator 
atong with VA, VB, and VC, the low-order bits from the vertical 
counter. For each character being displayed, the character 
generator puts out one of eight stored hit patterns selected by 
the three-bit number made up of VA, VB, and VC. 

The bit patterns from the character generator are loaded into 
the 74166 parallel-to-serial shift register and output as a serial 
bit stream that goes to the video output circuit (Figure 11-21). 
The shift register is controlled by signals named LDPS* (for load 
parallel-to-sertal shifter) and VID7M (for video 7 Mhz). in 
40-column mode^ LDPS* strobes the output of the character 
generator into the shift register once each microsecond, and 
ViD7M shifts the bits out at 7 MHz (Figure 11-22). 

The addressing for the 80-column display is exactly the same 
as for the 40-column display: the 40 columns of display memory 
in auxiliary memory are addressed in parallel with the 
40 columns in main memory. The data from these two 
memories reach the video data bus (lines VID0-VID7) via 
separate 74LS374 three-state buffers. These buffers are loaded 
simultaneously (at the rising edge of t^Q). but their outputs are 
sent to the character generator alternately by the falling edge 
of (AO and <^1. In 80-column mode, LDPS" loads data from the 
character generator hto the shift register twice during each 
microsecond, once during ii>Q and once during ^/j1, and VID7M 
remains low, enabling the clock continuously at 14M 
(Figure 11-23). 
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Low-Resotutton Dispfay 

In the graphics modes, VA and VB are not used by the 

character generator, so the lOU uses lines SEGA and SEGB to 
transmit HO and HIRES', as shown in Table 11-16. 



Tfftrle it-lff. Chsracter-Generator Control Signals 



Display Mode 
Text 

Graphics 



SEGA 



VA 



HO 



SEGB 



VB 
HIRES- 



SEGC 



vc 
vc 



The low-resolution graphics display uses VC to divide the eight 
display lines corresponding to a row of characters into two 
groups of four lines each. Each row of data bytes is addressed' 
eighl times, the same as in text mode, but each byte is 
interpreted as two nibbles. Each nibble selects one of sixteen 
colors. During the upper four of the eight display lines, VC is 
low and the low-order nibble determines the color. During the 
lower four display lines. VC ss high and the high-order nibble 
determines the color. 

The bit patterns that produce the low-resolution colors are read 
from the charactef-generator ROM in the same way the bit 
patterns for characters are produced in text mode. The 74166 
parallel-to-senal shift register converts the bit patterns to a 
serial bit stream for the video circuits (Figure 11-21), 

The video signal generated by the Apple lie includes a short 
burst of 3.58 MHz signal that is used by an NTSC color monitor 
or color TV set to generate a reference 3.58 MHz color signal. 
The Apple lie s video signal produces color by interacting with 
this 3.58 MHz signal inside the monitor or TV set. Different bit 
patterns produce different colors by changing the duty cycles 
and delays of the bit stream relative to the 3.58 MHz color 
signal. To produce the small delays required for so many 
different colors, the shift register runs at 14 MHz and shifts out 
14 bits during each cycle of the 1 MHz data clock. To generate 
a stream of fourteen bits from each eight-btt pattern read from 
the ROM, the output of the shift register is connected bacl< to 
the register's serial input to repeat the same eight bits: the last 
two bits are ignored the second time around. 

Each bit pattern is output for the same amount of time as a 
character; 1.02 microseconds. Because that is exactly enough 
time for three and a half cycles of the 3.58 MHz color signal 
the phase relationship between the bit patterns and the signal 
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changes by a half cycle for each successive pattern. To 
compensate for this, the character generator puts out one of 
two different bit patterns for each nibble, depending on the 
state of HO, the lovw-order bit of the horizontal counter. 

High-ResoiutiOn Display 

The hlgh-^eso^ution graphics pages begin at memory locatfons 
$2000 and S4000 (decimal 8192 and 16384). These page 
addresses are selected by address bits A13 and A14. In 
high-resoiution mode, these address bits are controlled by 
PAGE2 and 80STORE, the signals controlled by the 
display-page (PAGE2) and 80-column-video (80COL) soft 
switches. As in text mode. 80STORE inhibits addressing of the 
second page because there is only one page of 80-column text 
available tor mixed mode. 

In high-resolution graphics mode, the display data are still 
stored in blocks like the one shown in Figure 11-20, but there 
are eight of these blocks. As Tables 11-14 and 11-15 show, 
vertical counts VA, VB, and VC are used for address bits 
A10. All, and A12, which address eight blocks of 1024 bytes 
each. Remember that in the display VA. VB, and VC count 
adjacent horizontal lines in groups of eight. This addressing 
scheme maps each of those lines into a different 1024-byte 
block. 

It might help to think of this scheme as a kind of eight-way 
multiplexer; it's as if eight text displays were combined to 
produce a single high-resoJution display, with each text display 
providing one tine of dots in turn, instead of a row of 
characters. 

The high-resolution bit patterns are produced by the 
character-generator ROM. tn this mode, the bit patterns simply 
reproduce the seven bits of display data. The low-order six bits 
of data reach the ROM via the video data bus VIO0-VID5. The 
lOU sends the other two data bits to the ROM via RA9 and 
RA10. 

The high-resolution colors described in Chapter 2 are produced 
by the interaction between the video signal the bit patterns 
generate and the 3.58 MHz color signal generated inside the 
monitor or TV set. The high-resolution bit patterns are always 
shifted out at 7 MHz, so each dot corresponds to a half-cycle of 
the 3.58 MHz color signal. Any part of the video signal that 
produces a single white dot between two black dots, or vice 
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versa, is effectively a short burst of 3.58 MHz and is therefore 
dispfayed as color. In other words, a bit pattern consisting of ^^ 

alternating ones and zeros gets displayed as a line of color. The _^^ 
high-resolution graphics subroutines produce the appropriate bit 
patterns by masking the data bits with alternating ones and 
zeros. 



To produce different colors, the bit patterns must have different 
phase relationships to the 3.58 MHz color signal. If alternating 
ones and zeros produce a certain coior, say green, then 
reversing the pattern to zeros and ones will produce the 
complementary color, purpie. As in the low-resolution mode, 
each bit pattern corresponds to three and a half cycles of the 
color signal, so the phase relationship between the data bits 
and the color signal changes by a half cycle for each 
successive byte of data. Here, however, the bit patterns 
produced by the hardware are the same for adjacent bytes: the 
color compensation is performed by the high-resolution 
software, which uses different color masks for data being 
displayed in even and odd columns. 

To produce other colors, bit patterns must have other timing 
relationships to the 3.58 MHz color signal. In high-rGsolution 
mode, the Apple lie produces two more colors by delaying the 
output of the shift register by half a dot (70 ns). depending on 
the high-order bit of the data byte being displayed. {The 
high-order bit doesn't actually get displayed as a dot, because 
at 7 MHz there is only time to shift out seven of the eight bits.) 

As each byte of data is sent from the character generator to the 
shift register, high-order data bit 07 is also sent to the TMG. 
If D7 is off, the TMG transmits shift-register timing signals 
LDPS' and VID7M normally. If D7 is on, the TMG delays LDPS* 
and VID7M by 70 nanoseconds, the time corresponding to half 
a dot. The bit pattern that formerly produced green now 
produces orange; the pattern for purple now produces blue. 

A Note About Timing; For 80-column text, the shift register is 
clocked at twice normal speed. When 80-column text is used 
with graphics in mixed mode, the TMG controls shift-register 
timing signals LDPS* and VID7M so that the graphics portion 
of the display works correctly even when the text window is 
in 80-column mode. 
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Doubfe-High-Resolution Display 

Double-high-resolution graphics mode displays two bytes in the 
time normally required for one, but it uses High-resolution 
Graphics Pages 1 and IX instead of TeKt and Low-resolution 
Pages 1 and 1X, 

Note: There is a second pair, HRP2 and HRP2X, which can 
be used to display a second double-high-resolution page. 

Double-htgh-resolution graphics mode displays each pair of data 
bytes as 14 adjacent dots, seven from each byte. The 
high-order bit (color-select bit) of each byte is ignored. The 

auxiliary-memory byte is displayed first, so data from auxiliary 
memory appears in columns 0-6, 14-20. and so on, up to 
columr^s 547-552. Data from main memory appears in 
columns 7-13, 21-27, and so on, up to 553-559. 

As in BO-column text, there are twice as many dots across the 
dispiay screen, so the dots are only half as wSde On a TV set 
or low-bandwidth (less than 14 MH?) monitor, srngle dots will be 

dimmer than normai. 



RGB Stands tor red, green and 

Clue end identifies a type of color 
monitor thai uses inflependent 
inputs tor the three primary colors. 



For turthflr Information about 
double-High-resofution graphics 
display, refer to the Bibliography. 



Note: Except for some expensive RGB-type color monitors, 
any video monitor with a bandwidth as high as 14 MHz will 
be a monochrome monitor. Monochrome means one color: a 
monochrome video monitor can have a screen color of white, 
green, orange, or any other single color. 

The main memory and auxiliary memory are connected to the 
address bus in parallel, so both are activated during the display 
cycle. The rising edge of <pQ docks a byte of main memory data 
into the yideo latch, and a byte of auxiliary memory data into 
the 80 latch (Figure 11-21). 

Phi 1 enables output from the (auxiliary) 80 latch, and 
ii}Q enables output from the (main) video latch. Output trom both 
latches goes to CHARGEN. where GR and SEGS* select 
high-resolution graphics. LDPS operates at 2 f^Hz in this mode, 
alternately gating the auxiliary byte and main byte into the 
parallel-tO'Serial shift register. VID7M is active (kept true) for 
double-high-resolution dispiay mode, so v^hen it is ANDed 
with 14M, the result is still 14M. The 14M serial clock signal 
gates shift register output to VID, the video dispiay hybrid 
circuit, for output to the display device. 
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Figure 11-22. 7 MHz Video Timing Signets f40-Coiumn, Law-Rssofution an(3 High-ResoiuUon Display} 

i^^ruinjinnJiJmnnjmjinMjmnnjirijrini^ 



7M 



*0 



*1 — I 



©- 



Vid^o Phase 



CPU Phase 



DATA BUS ^ X ^ 



VIDEO LATCH 



LDPS* AND ENSO' 



VIDEO BUS Into CHARGEN 



1 

x: 



0- 



>c 



:x 



"LT 



OK 



J 



J 



OUTPUT BUS Into SPI [Shift Register) 



SPI Serial Output (VID7M and 14M) 



X 



:x 




-1 



2461 



Chapter 11: Hardware Implementation 







Figure 11-23, 14 MHz Vi6eo Timing Signals {80-Cotumn and Doutle-High-Resofution Disp/ay) 
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VID is a video-am pi I (ier hybrid 
circjit. 






Back Panel 



> 



It. 9^5 Video Output Signals 

The stream of video data generated by the display circuits 
described above goes to a hybrid circuit (VID) that adjusts the 
signals to the proper ampiitudes and conditions the color burst. 

The resuitfng video signai is an NTSC-compatible 
composite- video signal that can be displayed on a standard 
video monitor. The signal is similar to the EIA (Electronic 
Industries Association) standard positive composite video. This 
signai is available in two places tn the Apple lie (Figure 11-24): 

• at the phono jack on the back of the AppJe lie 

• at the video expansion connector (pin 12) on the back panel. 
(Table 11-17). 

Figure 11-24. Video Output Back Pane) Connectors 
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\m\ Di 

pGND 




VIOOUT 



Video ViflBD Output Connector 

E^ipansion Connector (For ^ Monitor) 

(For an RF Modulator 
or Special AdapLor) 
(SseFig. 11-25] 



i^ 



Monitor Output 

The sleeve of the phono jack at the center of the Apple lie 
back panel is connected to ground and the tip is connected to 
the video output through a resistor network that attenuates it to 
about 1 volt and matches its impedance to 75 ohms. This 
arrangement is suitable (or most video monitors. 
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Video Expansion Output 

The back panel of the Apple lie has a DB-1S connector for 
sophisticated video interfaces external to the computer. 
Figure 11-25 shows the pin assignments for this connector; 
Table 11-17 describes the signals. 

In Table 11-17, the column labeled Deriv indicates what clock 
signals the video signals are derived from. LDPS, CREF and 
PRAS have a maximum delay of 30 ns from, the appropriate 
14 MHz rising edge. SEROUT is clocked out ol a 74LS166 by 
the rising edge of 14M and has a maximum delay of 35 ns. 
VIDD7 is driven from a 74LS374 and has a maximum deiay of 
28 ns from the rising and (if BO-column) falling edges of </>1. 

To align CREF so it is in the same phase at the beginning of 
every line, certain clock signals must be stretcffecf. This stretcfi 
is for one 7M cycle (140 ns), and occurs at the end of each 
video line. AH timing signals except HW, 7M and CREF are 
stretched. 

Warning 

The signals at the DB-15 on the Apple ffc are not the same as 
those at the 06-15 on the Apple Hi. Do not attempt to ping a 

cable fntendsd for one into the other. 



Warning 

Several of these signals, such as 14 MHz. must be buffered 

Within about four inches (10 cm) of the back panel connector— 

preferably inside a container directly connected to the back 

panel. For technical information, contact Apple Technical 

Support. 
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Figure 11-25. 7/)e Video EKpansion ConnBctor Pinovts 
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Pin Si anal 
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TEXT 


9 


PR AS* 


2 


MM^^- 


10 


GR 


3 


SYNC* 


11 


SEROUT 


4 


SEGB 


12 


NTSC 


5 


IVSOUND 


13 


GNO 


B 


LDPS' 


14 


VIDD7 


T 


WNDW 


IS 


CREF 


8 


+ 12V 
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Table 11-17. The Video Expansion Connector Signals 



Pin 



Deriv 



iName 



Descriptiofi 



2 
3 



5 
B 

7 



10 
11 

12 

13 
14 

IS 



^ TEXT 

14MN<. 
03 SYNC" 

PRAS SEQB 

ly/souNO 

14MI^ LDPS' 
PRAS WNDW* 

+ 12 V 
14M^,' PRAS' 

PRAS GR 



14M 



SEROUT' 



NTSC 





GND 


E>n 


VIDD7 


14W-':. 


CREF 



Video text signal from TMG; set 
to inverse of GR, except in 
doubie-^iigh-resolution mode 

14 MHz master timing signal from 
the svstem oEcillator 

Display horizontat and vertical 

synchronization signal irom JOU 
pirt 39 

Display vertical counter bit from 

lOU pin 4; in text mode indicates 
second low-order vertical counter; 

in graplnics mode indicates 
low-resolution 

One-volt sound signal from pin 5 
of the audio hybrjd circuit (AUD) 

Vi(Jeo shitt-r&gister load enable 
from pin 12 of TMG 

Active area display blanking: 
includes both horizontal and 

vertical blanking 

Regulated +12 votts DC; can 
drtve 350 mA 

RAM row-address strobe from 
TMG pin 19 

Graphics mode enable from lOU 
pin 2 

Serialized character-generator 
output from pin 1 of the 74LS166 
shift register 

Composite NTSC video signal 
fromi VID hybrid chip 

Ground reference and supply 

Ffom 74LS374 video iatch; causes 
halt-dot shift if high 

Color reference signal from TMG 
pin 3; 3.58 MHz 



1 1 .9 The Video Dtsplay 



1251 



Warning 

Use caution— The maximum aUowabie current dram of -f-12 V 

reguiated power at the video expansfon connector is 

300 milUamps. if the externat device draws more than this, it 

can damage the computer or cause the power supply to shut 

down. 



11,10 Disk t/0 



Disk I/O— for both the built-in and the external drive — is 
supported by the IWM disk controller unit. The external drive is 
attached via a DB-19 connector Figure 11-26 shows this 
connector. Tabte 11-18 descnbes the pin assignments. Supply 
voltages come from the power supply; ali other signals come 
from the IWM, described in section 11.5.5. 

Figure 11-26. Disk Drive Connector 



96765432 

19 18 17 16 15 14 13 12 11 



Pin 



Siqnal 



Pin 



Signal 



1^2.3<4 


GND 


13 


SEEKPH2 


5 


-12V 


14 


SEEKPH3 


6 


+ 5V 


15 


WRREQ* 


?.8 


+ 12V 


16 


N.C. 


9 


EXTINT- 


17 


■DR2* 


10 


WRPROT 


IB 


HDD ATA 


11 


SEEKPHO 


19 


WRDATA 


12 


SEEKPH1 







Warning 

The power avaiiabfe at this connector is for a Disk fl or similar 
drive only. Do not use power from the external disk connector 
for any other purpose— you may damage the internal voltage 
converter To derive externai power for an attached device, use 
one of the other connectors and observe the current limits 
given in this manual. 



252 1 



Chapter 11: Hardware Implementation 



i 

■J 

J 



"J 

- 



Tabie 11- IS. Disk Drive Connector Signais. "Re^&r to t/re warning precsdirtg this 
table. 



Connecter 






Pin Numb«r 


Name 


Description 


1 ,2.3,4 


GND 


Ground reference and sjpply 


6 


+S V 


+ b volt supply" 


7.8 


+ 12 


+ 12 volt supply*' 


9 


EXTINT' 


External interrupt 


10 


WRPROT 


Wrile-protect input 


11-14 


PHO-4 


Motor phase 0-4 output 


15 


WRREQ" 


Write Request 


17 


DRV 


Drive t select 


18 


RDDATA 


Read data mpiit 


19 


WRDATA 


Write data ojtput 



11.11 Seriaff/O 



The RS~232 signals are defined m 

the Glossary. 



Apple lie has built into it two 6551 Asynchronous 
Communication Interface Adapters (ACIA) and supporting input 
and output buffers for full-duplex serial communication. 
Figure 11-27 is a block diagram of the Apple He serial ports, 
ACIA outputs are buffered by a 1448 quad line driver. Similarly, 
ACiA inputs are buffered by a 1489 quad line receiver. 

Figure 11-28 is a detail block diagram of the 6551 ACIA. The 
registers are described in sections 11.11.1 throughi 11.11.4. 
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figure 11'27- Serial Port Circuits 



eXTINT- 



At , 



A4 



/\ 



a 
a 









^0 



IRQ" 



DSR- 



fi551 

ACIA 

SER1 



GTS- 



RESET'I 



TxO 



RTS- 



HxO 



DGD" 



SER* 



SCLK 






MM 



74LS161 



IRQ- 

1 



\/ 



\ur7y 



AO 



*- 



A1 



A5 



\7 



6551 

ACtA 

SER3 



DSR' 
CIS 



RESET ^ 



^ 



\J 



BCLK 

SER 

■4 



TkD 



HTS" 



RkO 



DCO' 



kstrb 



(From External Disk Drive Connector) 




1488 

(Serial 

Output 
Buffer) 



1469 

{Seriah 

Input 

BuHef) 



(Ffom Keyboard) 



Pin 



1 I? 



DTR1B 
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J22I^2X 



DTR2B_^ 
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Figurs 11 -2&. 6551 ACIA Bfock Diagram. Copyright 1378. Synertek Inc. 
Used by permission of Synertek Inc.. 3i>0J Stsnder, Santa Clara, CA 95052. 
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Figure 11-29. The 6551 Ptnouts 
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The 6551 pin assBgnments are shown in Figure 11-29 and 
described in Table 11-19. Note that the two 6551s are not used 
in exactly tlie same way^each one supports a different set of 
inlerrupts. 

Port 1 reads external interrupts (EXTINT') on its Daia Set 
Ready (DSR) pin. This input is tied to +5 V through a 3,3 Kohm 
pullup resistor. 

Tffbfe 11-19. The 6551 Signat Dsscriptions 



Pin Number 


Name 


Descriptlon 


1 


GND 


Power and signal dommon ground 


2 


A4 


Address line 4 to select serial 
port 1 




A5 


Address line b to select serial 
ports 


3 


SER- 


Serial device select from GLU 


4 


REsei- 


Resets both serial ports 



5 

7 

S 

9 

10 

11 

12 

13.14 

15 

IB 

17 

1B-25 
26 
27 
28 



8CLK 

RTS" 
CTS' 
TXD 

RXD 
A0,A1 

+ 5 V 

DSR 
EXTINT* 

KSTFia 

OO D7 

IRQ' 
PHO 

Ryw 



No connection 

Baud rate clock from GLU 

No connection 

R&qjest to Send output 

Clear to Send input 

Transmit Data output 

bio connection 

Receive Data input 

Address lines and 1 

+ S volt supply 

Data Set Ready input 

External interrupt (port 1 ACIA) 

Keyboard Strobe input {port 2 
ACIA; Appendix E) 

Eight'bit data bus 

interrupt Request input 

Ptiase clock pulse 

Read/write seiect input 
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The back panel connectors for both serial ports are 5-pin DIN 
jacks. The pin assignments are shown in Figure 11-30 and 
described in Table 11-20. 

Figure 1 f-30. S&fai Pert Connectors 



Pin 




Port 1 



Port^ 



1 


DTB1B 


0TR2G 


- ^ 20 


2 


TD1B 


TD2B 


rt 
i 


3 


GND 


GND 


7 


4 


PD1B 


RD2B 


3 


5 


DSP1B 


DSR2B 


■ € 



1 

1 



^ ''">{1'5-;o-»''.>; 
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Tabie 11-20. Sehai Port Connector Slgnais 



Pin Number 
1 



3 
4 



^ame 

DTR1B 

DTR2B 

TD1B 

TD2B 

GND 

RD1B 

RD2B 

DSR1B 

DSR2B 



Description 

Data Terminal Ready output 

Transmit Data output 

Power and signal com man 
Read Data input 

Data Set Ready mput 
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71.11.1 AC/A Control Register 

Figure 11-31 shows the bit assignments tor the ACIA Control M^ 

Register, which the hardware locates at address $C09B for 

serial port 1, and SCOAB for serial port 2. This register 

determines the number of data and stop bits the ACiA will 

transmit and receive, and the clock source and baud rate to use 

for data transfer. 



The receiver dock source is derived from the Apple lie's TMG 

chip; the resulting baud rates are equal to or up to 2% lower 

than the nominal rate. (The EIA standard allows plus or 

minus 2% variation,) If an Apple He serial port is used with a -^ 

modem that is 2% above the nominal rate, framing errors can 

occur, especially at 1200 baud and above, when using eight ^^ 

data bits. It may be necessary to select a lower baud rate for ^ 

8-bit binary data transfers. 



U^ 



iu^ 
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Figure 11-31, AC/A Control f^&gister Copyright 197B, Sypertek inc. 

Used by permission of Synertett Inc.. 300 J Slender, Santa Ctara, CA 950^2. 
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11.11.2 ACIA Command Register 

Figure 11-32 shows the bit assignments for the ACIA Command 
register, which the hardware locates at address $C09A for 
serial port 1. and at SCOAA for serial port 2. This register 
controls specific transmit and receive functions: parity checking, 
echoing input to output, atiowJng transmit and receive interrupts. 
and setting ieveis for Data Terminal Ready and Request to 
Send. 



Figure 11-32. ACIA Command Regt^t^t. Copyright W78. SyneneH inc. 
Used ijy p&rmisSiOfi of Syneft&k Inc.. 30OJ Slender. Santa Ciara. CA 95052. 
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ft 11.3 ACiA Status Register 

Figure 11-33 shows the bit assignments for the ACfA Status 
Register, which is hard-wired to address SC099 tor serial 
port 1 . and $C0A9 for serial port 2. This register reports th© 
condition of the transmit/receive register, errors detected 
during data transfer, and the level of the Data Carrier Detect, 
Data Set Ready and interrupt request lines. 

figure 11-^3. AC/A Status Register. Copyright 1978, Synertek inc. 
Usea&y permission of Synertek fnc, S001 St&nder, Santa Ciara. CA 35052. 
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11,1t,4 ACiA Transmit/Receive Register 

Each ACIA uses the same address— $C098 for serial port 1 , 
$COAB for serial port 2 — ^as temparary data storage for both 
transmission and reception ot data. 

When the register is used for transmitting data^ bit is the 
leading bit to be transmitted; unused data bits are the 
high-order bits, which are ignored. 

When the register is used for receiving data, bit is the first bit 
received: unused data bits are the high-order bits, which are set 
to Parity bits never appear in the receive data register; they 
are stripped off after being used for external parity checking. 



71. 12 Mouse input 



The mouse is a hand-held X-Y pointing device that can be rolled 
along a flat surface. It has an attached pushbutton. This section 
describes how mouse movement and direction can be detected 
and interpreted. 

A mouse has a ball inside its housing that protrudes a small 
distance so that its turning corresponds to mouse movements 
across a tabletop. Two wheels inside the housing, set at 
90-degree angles to each other, follow movements of the ball; 
this causes two disks to rotate. The disks have rectangular 
holes arranged near their edges, making them resemble circular 
slide mounts used with stereoscopic slide vievt^ers. 

The light from a tiny infrared emitter reaches a photoreceptor 
whenever one of the holes on the disk lies between them. An 
internal circuit tn the mouse causes the resulting voltage to 
swing quickly to a 1 or a value as soon as a certain threshold 
is crossed. The result is something approximating a square 
wave (Figure 1 1-34) that varies directly with the speed of mouse 
movement One of these indicates the X component {XO} of 
mouse movement; the other, the Y component {YO). 

Under program control, either the rising edge or the falling edge 
of each square wave can cause an interrupt, which the firmware 
handles by updating a counter. However, the program needs to 
know whether to add or to subtract 1 from a counter; that is, it 
needs to know the direction of X or Y movement. 
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Figure 11-34. Sample Mouse Waveform 



Movement 
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Mouse 
Speed 

There is a second infrared emitter/photoreceptor pair almost 
180 degrees opposite the first pair for each disk. These pairs 
are positioned in such a way that the square waves they 
generate are approximately a quarter-wave offset from their 
respective movement waves (Figure 11-35). These waveforms 
are called X1 (X direction) and Y1 (Y direction). 

When a rising edge of XO causes an interrupt, a mouse-driver 
program can immediately check whether XI is (indicating a 
movement to the right) or 1 (indicating a movement to the left). 
Similarly^ the mouse driver can read Y1 immediately after a 
YO interrupt to determine whether the mouse moved up or 
down one count along the Y axis. 

Figure 11-35. Mouse MavBrnsnt antf Direction Waveforms 
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11.12 Mouse Input 



Figure 11-36 shows the pin assignments for the mouse DB-9 
connector on the back paneL Table 11-21 gives the signal 
names and descriptions. 

Figure 11 -3S. Mouse Connector 
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© ^N.C) 






7 MSW^ 






8 YDIR 






9 YMOVE 






Tsble 11-21. Mouse Connector 




DB-9 


Signa! 




Pin Number 


Name 


Description 


1 


MOUSEIO^ 


Mouse idenlifier; wnen active, 
disables f4E556 hand controller 
timer. 


2 


+ 5V 


Total currerii' drain From this pin 
must not exceed lOQ mA. 


3 


QND 


System ground 


4 


XI 


Mouse X-direction irdicator 


5 


XQ 


Mouse X-movement interrupt 


e 




Mouse burton 


7 


MSW 


Mouse button 


B 


Y1 


Mouse Y-directiOh Indicator 
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YO 


Mouse Y movement mterrupt 
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Figure 11-37 shows the mouse and hand control circuitry with 
the mouse circuits highlighted. Figure 11-38 illustrates the 
values of the mouse-button circuit when the button is pressed 
or not pressed. Pressing the button disables the NE556 by 
pulling the reset comparator threshold vaiue up so that it cannot 
reset the flip flop. As a result the mouse-button Input value 
remains at a TTL level. 



Figure 1 1-S7. Mouse Circuits 
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Figure if -36. Mouse Button Signals 
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1 1 13 Hand Controffer Input 



Several input signals that are Individually controlled via soft 
switches are collectively referred to as the hand controMer 
(game) signals- These signals arrive in the Apple tic via the 
same DB-9 connector as the one used for the mouse 
(section 11.12), but the Apple lie interprets these signals 
difterently. 

The DB-9 connector pin assignments and signal descriptions, 
as used for hand control input, appear in Figure 11-39 and 
Table 11-22. 

Even though they are normally used for hand controls, these 
signals can be used for other simple I/O applications. There are 
two one-bit switch inputs, labeled SWO and SW1 , and two 
analog inputs, called paddles and labeled PDLO and PDL1. 
Figure 11-40 shows how to connect the one-bit switch inputs 
for compatibility with ail other Apple II series computers. 

The switch inputs are multiplexed by a 74LS251 S-to-1 
multiplexer enabled by the C06X* signal from the MMU. 
Depending on the low-order address, the appropriate game 
input is connected to bit 7 of the data bus. Figure 11-41 shows 
the mouse and hand control circuitry with the hand control 
circuits highlighted, Figure 11-42 illustrates the values of the 
hand-controJ switch inputs when the switch is open or closed. 

Figut^ 11-39. Hana Controffer Connector 
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Pin Siginal 
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2 
3 
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5 
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GND 
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hand contrnls 
PDLO 

GAMES WO 
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hand controls 
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Tabic 11-22, Hand Contfoi Connector Signals 



Connector 
Pin Number 



Signal 
Name 

GAMESW1 



+ 5V 



3 

4,9 
5,8 



GND 



PDLQ and PDL1 



N.C. 
GAWESWO 



Description 

Switch input 1 (sometimes called 
paddle button 1) 

-^5 V piQwer supply, Total current 

drain from this pin mjst not 
eKceed 100 mA. 

System ground 

Not used for hand controls 

Hand control inputs. Each of these 
must be connected to a tBO Kohm 
variable resistor connected 
to +5V. 

Not Connected 

Switch Input {somelimes called 
paddle button 0] 



Figure 11-40. How to Connect Switci} Inputs 
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Figure 11-41. Hand Contrat Circuits 
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Figure 11-42. Hand Controt Signets 
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The hand-control inputs are connected to the timing inputs of 
an NE556 dual analog timer. Addressing $C07X sends a signal 
from MMiJ pin 22 that resets both timers and causes their 
outputs to go to 1 (high). A variable resistance of up to 
150 Kohms connected between one of these inputs and the 
+ 5 V suppiy controls the charging time of one of the two 
0.022 microfarad capacitors. 

When the </oJtage on the capacitor passes a certain thresholdn 
the output of the NE556 changes back to {low). Programs can 
determine the setting of a variable resistor by resetting the 
timers and then counting time until the selected timer input 
changes from high to low. The resulting count is proportional to 
the resistance. 

Warning 

The only way to ensure correct paddie vaiues is to make sure 
the output of the paddle you irttencf to read is tow before you 
trigger the timer. Triggering the timer starts the charging cycle 
for the capacitor in each paddle circuit: the cyde for one may 
not be completed by the time you have read the other. If you 
retrigger or read the other paddie too soar} (that is, /r? tess thar} 
3 rrrsj, you wiU get a false value for it 



11,14 Schematic Diagrams 



The foliowing pages contain schematic diagrams for the 
Apple lie. 
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References to entries in Vofume 2 are fn square brackets 






Cast of Characters 

*(asterisK) 179 

\ (backslash) 59 

_ (blinking underscore cursor) 154 

> (greater than sign) 59 

? (question marh) 58, 59 

I (right bracket) 59 

A 

A register 17 

accumufator 17 

ACIA 134, 148. 253-262, [63] 

block diagram 255 

interrupts [60) 
address bus 12, 213 
AKD 218-219 

ALTCHAR 104-105. 218, [73] 
alternate character set 68, f73j 
ALTZP 25, 26, 216. [46] 
analog inputs 176. [68J 
annunciator outputs [76] 
ANSI [84] 
any-key-down 79. 229 

flag [66] 
Apple Extended 80-Column 

Te?(1 Card [67, 74] 
Apple Language Card [64| 



Apple El series differences [60-78] 
Apple lie 

block diagram 210 

care of 205-206 

differences from Apple Ife [61-78] 

expansion 2 
Apple lie ROMs [72] 
Applesoft cS commands 52 
Applesoft BASIC 59, [16-18, 40] 

BASIC interpreter 24 
Applesoft interpreter 21 , 224-225 
arithmetic, hexadecimal 193 
ASCII [71, 83. 86-87] 

character set 79,197,114-122] 
assemblers 199 

assembly language, and mouse 171 
asterisk {*} 179 
automatic line feed 131, 145 
automatic repeat 3 
Autostart ROM [69] 
auxiliary memory screen holes 
135-136, 149-150 
See afso screen holes 
auxfliary RAM 20 
AUXMOVE See MOVEAUX 
AY-3600-type keyboard decoder 229 



Jndex 



1 279 



B 


C3KEYIN 55 


H 


CALL Statement 179 


eS 


B command 131^ 144 


Canadian keyboard [91] 


*i 


back panel B, 9 


cancel line 62 


J 


backslash 0) 59, 62 


rcAPS-LOCK) 4. 79, [84] 


c3 


backspace 62 


Gard(s) [74,75] 


"n 


bank 25 


care of computer 205-206 


1 


bank-switched memory 22, [64, 69) 


carriage return 139. 152 


cd 


BANK2 216 


carrier 137 


M 


BASIC 130. 163,175-177,179,180, 


CAS (column-address strobe) 226 


J 


192, [1141 


cassette input and output [67-68, 77] 


td 


and assembly language support 171 


certifications [99] 


tr* 


and hand controls 173 


CH (cursor horizontal) 63 


J 


and mouse 163, 172 


changing memory contents 184 


Ed 


S/^S/CSdisK [39, 69| 


changing registers 190 


M 


baud rate 137, 258 


character(s) 


J 


BCLK 256 


flashing 68 


cd 


BELL 84 


generator 241 


r- 


BELLI 84 


inverse 68 




BIT instruction [3] 


normal 68 


Ei 


bits [103] 


sets [71.73] 


t^ 


blanking Intervals 233 


chips, custom [76] 




blinking underscore cursor (_) 154 


clamping boundaries 171 


e:^ 


block diagrams 


CLAMPMOUSE 168 


if 


ACIA 255 


CLEARMOUSE 168 




Appte lie 210 


CLEOLZ 116 


p 


BREAK 132, 137, 145 


dock 211 


break instructions [481 


master 213 




BREAK signal [75| 


system 213 


p 


BRK 75, 189, [43] 


CLREOL 116 


buffer 59 


CLREOP 116 




senal I/O [75] 


CLRSCB 117 


c^ 


buitt-in diagnostics [62] 


CLRTOP 117 


fe- 


built-in disk drive B 


code conversions [114-122] 




built-in self-tests [651 


cold-start procedure 49, 50 


sr* 


button interrupt mode 164, 167 


colors 


^ 


bypassing firmware [58-60] 


high-resolution 243 




bytets) [103. 104] 


low-resolution 242, [63] 


^ 


power-up 51 


command character 146. [75] 




command register 134, 148, 260 




c 


Communicalion Card [74] 


P 


>^ A. A k Ji f\Fk^ 


communication port 141 


C06X 267 
C07X 217 


comparing data in memory 188-189 


^ 


C3COLIT1 55, 64 




Index 




1= 



3 






connectQr(s) 

back panel 8-9 

game [76] 

power 207 

serial port 257 
CONTINUE BASIC command 192 
CCONTROQ 4, 79, 229 

transterring 42-43 
control characters 64 
control register 134, 148. 258-259 
CONTROL-A, as command character 
143 

CCONTROL> rcl [53] 

CcontrolK TD 62 

CONTROL I, as command character 

130, 132 
CONTROL'K, as command character 

193 
[ CONTROL V rF) 56. 126, 142 

as command character 193 
[ CONTROL V Th^ 155 
t CONTROL K s^ [53] 
f CONTROL K Ti 156, 159 

( CONTROL K X) 62 

( CONTROL K D 197 

commands 52 
CONTROL RESET 50 
conversion, number flOS] 
COUT 55. 117, 191 
C0UT1 55, 63, 117 
CP/M [40] 
CPU See65C02 
OR See carriage return 
CREF 220. 221, 251 
CROUT 117 
CR0UT1 117 
CSW 56. 70, 104 
cursor 58, 130, 143, 193 

blinKIng underscore {_) 154 

flashing checkerboard 55 

flashing question marK 130, 143 

Inverse solid 55 



Index 



custom chips [78] 

custom integrated circulEs 215-223 

CV 63 

D 

D command 131, 144 

data, transferrfng 41-42 

data bits 137 

data bus 21 3 

Data Carrier Detect [60] 

data format 137, 138, 144, 151 

data inputs 21 

Data Set Ready See DSR 

Data Terminal Ready See DTR 

DCB 261 

DCD [60] 

decimal negative [107] 

device signature 72 

DEVNO [21 J 

DHIRES 49, 104, 106. 107. 166 

diagnostics, built-in [62, 65] 

differences among Apple ll's 161-78] 

disable MouseText 65 

DISK 221, 222 

disk 

controller cards [74] 

controller unit See iWM 

input and output 124-126 

I/O firmware entry points 20 
disk drive 8 

connector 252 

port [50] 

speed 13 
disk -use light 6, [71] 
display 

address mapping 235-238 

inverse 191 

memory addressing 234 

memory switches 43-47 

modes 104-108,239-247 

normal 191 

page maps 108-114 

pages 102-103 
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DISVBL 166 

DISXY 166 

DMA transfers [70] 

DOS 126, 130, 143, 179, 180, L39, 69] 

interrupts |4.2] 

zero page use [16-1B] 
dQuble-high-resolution 245 

graphics [7^ 

colors 100-101 
drive, external, startup 126 
drive motor 49 
DSR 256, 261, [60J 
DSR1B 257 
DSR2B 257 
DTR 260 
DTR1B 257 
DTR28 257 
dumb terminal 159 
Dvorak keyboard 6, [88] 
dynamic RAW refreshment and timing 
226-229 

E 

echo 131. 145, 155. 260 

EIA standard 258 

60 columns 65, 93 

80/40 column switch 5 

80COL 104, 105. 107, 108. 218. 219, 

220 
80STORE 39, 44, 45. 104. 105, 107, 

10B, 216, 238, 241 
electrical power 206 
EN80 217 

enable MouseText 65 
ENBVBL 166 
ENBXY 166 
ENCLCRAM 216 
English keyboard [90] 
enhanced video firmware 20, 224 
enter terminal mode 145 
entry points, firmware [31-36] 
environmental specifications 205-206 



(J|g3 4 
fEscl lD 61 
fEsDlD 61 
escape codes 60 
escape sequences 4 
even-parity [114] 
EXAMINE command 190 
examining memory contents 1B1 
examining registers 190 
expansion ROM space 73 
Extended 80-Column Text Card [64] 
external drive startup 126 
external interrupts [55] 
external power connector 207 
EXTIMT 256, [55. 60] 



FCC [99] 
firmware 1 2 

entry points |30 36] 

listings [126-215] 

locations [30^36] 

protocol 71, 134. 148 

video routines 115-123 
flag inputs 21 
FLASH 256 
flashing characters 68 
flashing checkerboard cursor 55 
flashing power light 6 
forced cold start 50 
14M 215. 220. 221 
FORTRAN [41] 
40 columns, switching to 80 5 
40-column 65, 93 
48K memory 34, 35, 39 
framing errors 258 
French keyboard [91-92] 
full duplex 156-158 



3 

3 






^ 
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GAME I/O connector [76] 

game input 267 

game paddles See hand controls 

GAMES WO 268 

GAMESW1 268 

General Logic Unit (GLU) 13 

German keyboard [93] 

GETLN 58 62, ISO 

GETLN1 59, 82 

GETLNZ 82 

GLU 221 

GND 257 

GO command 189, 190, 192, 198 

graphfc bits [109] 

graphics mode 96-102 

greater than stgn (>) 59 

H 

half duplex 155 

hand control 8, 173-178 

circuits 269 

connector 174 

Input [76] 

sfgnals 270 
hand controller 267 
handle 9, 206 
hardware 

accesses 21 

addresses [66] 

locations 181. [15] 

page focations 164 
headphones 232 
heat 206 
hexadecimal [106] 

arithmetic 193 



high-resoiution 97 

colors 243 

display 243 

double 245 

graphics colors 98-99 

Page 1 37 

Page 2 38 
H!RES 44, 45, 104, 105, 107, 216, 

218, [67] 
HLINE 117 
HOME 118 
HOMEMOUSE 168 
HRP1 37 
HRP1X 37, 45 
HRP2 45 
HRP2X 38 
humidity 205 

/ 

I commancf 131, 145, 158 

I/O ffrmware, video roulines 120-123 

I/O links 55 

icons 68 

Identification bytes 71 

lEC [991 

IN#2 143, 154 

IN#n 56, 70 

index registers 17 

INH 217 

INITMOUSE 169 

input and output, disk 124-126 

input buffer (page $02) 36 

Input/Output Unit (lOU) 13,215, 

218-219. [78] 
instruction cycle times [63] 
Integer BASIC 59. [16-18, 41, 69] 
Integrated Woz Machine (fWM) 13 
internal converter 208 
internal voltage converter 206 



Indest 



(283 



interrupt(S) 24, 75, 260. [40^60, 70] 


J 


ACIA [49] 

Apple II and [42] 
Apple II Plus and [42] 

- lb lijni 




jack 7 

JMP SCGOO 126 

JMP indirect instruction [3] 


Apple Me and [43] 
disk drive port [49] 




joysticks See hand controls 


DOS and [42j 




M^ 


keyboard 152-531 




K 


Monitor and [421 




K(1024) 17 


mouse [49] 




K command 131, 145 


Pascal and [42] 




KBD 217 


B5C02 and 143] 




keyboard 229-231 


6551 [49] 




buffer [52-53] 


vertical blanking [49] 




character decoder 225 


interrupt handlers) 




circuit diagram 230 


mouse 163 




data [66] 


user's [57] 




input buffer 37 


interrupt requests 52 




interrupts [52^ 53] 


interrupt vector [43-44] 




layout [71] 


interrupt-liandling sequence 


[45] 


ANSI [90] 


inverse 65 




British See English 


characters 6B 




Canadian [91 92] 


display 191 




Dvorak [88] 


solid cursor 55 




English [90] 


INVERSE command 191 




French [91-92] 


in\foking the monitor 179 




German [93] 


lOREST |36] 




ISO [90] 


lORTS [36] 




Italian [94-95] 


lOSAVE [36] 




Sholes [85] 


lOU (Input/Output Unit) 13, 


215,. 


Western Spanish [96] 


218-219, [78] 




signals 231 


lOUDIS 49, 104, 106, 166, 


[67. 681 


strobe 79, 229, [50, 66] 


lOUSELIO 219 




switch 5 


IRQ 73. 156. 219, [43] 




standard 5 


handling routine [34] 




KEYIN 55. 57, 58 


vector [36] 




KSTRB 77. 219, 256 


ISO [84] 




KSW 56,57,70, 104 


layout [89] 






Italian keyboard [94] 




L 


IWM (Integrated Woz Machine) 13, 




222 




L command 131, 145 
LANGSW 256 
LDPS 220. 241, 251 
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OS 



Ime feed 145, 152 

automatic 131 
line length 136, 150 

line voltage 205 
iine width 139. 144 
LiST command 199 
local 154 
iow-resoJution 

colors 242 

dfsplay 242 

graphics 96 

M 

machine identification [631 

main memory screen holes 135-136. 

149. 150 
main RAM 20 
MARK (1} 132 
MARK parity 138, |114] 
master clock 213 
maximum current drain 252 
memory 

addressing 223-229 

bank-switched 22 

bus organization 224 

comparing data in 188-189 

display switches 43-47 

dump 182-184 

examining contents 1 8 1 

48K 34 

map 18, [15-281 

moving data in 186-188 

organization [64] 

state [48] 

switches, display 43-47 
Memory Management Unit See MMU 
microprocessor, 65C02 12, 15 
mini-phone jack 7 
MJXED 105, 107, 218, (671 
mixed-modes dispfays 102 
MMU 13, 215-217, 267, 271, [78] 
mnemonic 199 
modem: B, 151 
modes, display 239-247 



Index 



monitor 8, 24, 59, 179-203, 224 

entry point 136] 

interrupts and 142] 

output 248 

register commands 189-190 

ROM [69] 

video routines 115 

zero page use [15| 
mouse 8, 160-174, |49-50] 

BASIC and 163, 172 

Pascal and 171 

button 171 
interrupt mode 164 
signals 266 

clamping boundaries 171 

connector 264 

direction [59] 

firmware 167 

firmware entry points 20 

hardware locations 164-167 

Input 262, [76] 

interrupt handier 165 

interrupts [58J 

movement interrupt mode 163 

operating modes 163 

port 161-174 

transparent mode 163 

waveform 263 

X direction 167 

Y direction 167 
MOUSEID 264 

MouseTexl 65, 68-69, 90-91, [73, 114] 
M0UX1 167 
M0UY1 167 

MOVE command 186-188, 195, [36] 
MOVEAUX 41-42 
movement/button interrupt mode 164, 

167 
movement interrupt mode 163, 167 
moving data in memory 186-188 
MSLOT [21] 
MSW 264 
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N 

N command 131, 145, 156 

n CONTROL-K 56 

NE556 265, 271, [77] 

negative decimal [107J 

NEWIRQ [34] 

nibble [104| 

NMI vector [36, 43| 

non-maskable interrupts 52 

NORMAL command 191 

normal characters 65, 6& 

normal display 191 

NTSC 87, 233. 242. 248. 251 

#6 130 

#7 143 

#8 143 

o 

odd-parity [114] 

old monitor ROM [62] 

1 CONTROL-P 130 

1VSOUND 251 

C^ 4, B2 

operand 199 

operating systems [39-40J 

operating temperature 205 

output and input, disk 124-126 

output jack 232 



P command 132, 14S 
P register 17 
paddle(s) 267 

button 268 

button 1 268 

inputs [68, 76J 

timing circuit [77] 
page 18 

page $02 (input tJUffer) 36 
page $03 36 
page $04 36 
page $08 37 



page 18 

page zero 24 

page 1 18 

PAGE2 44-45, 105, 107-108, 216, 

238.241. [46-48, 67] 
page ttiree [19] 
page 8, auxiliary RAM [52] 
PAL 233 
parity 145 

bit(5) 138, 262 

checking 260 
Pascal 67, 126. 130, 134, 170, [114] 

ID byte 134. 148 

interrupts and [42] 

language [41] 

operating system [40] 
PC (program counter) 16 
PCAS 220 
PDLO 176 
PDLO/XMOVE 219 
PDL1 176 
PEEK [40] 

peripheral identification numbers [112] 
peripheral -card memory space [65-66] 
peripheral -card ROM space [65] 
phone jack 7 
PiN numbers [112] 
PINiT 72, 121. 134. 148 
PLOT 118 
plotter 8 
POKE [40] 
ports 70, [70] 
POSMOUSE 168 
power 8 

connector 207 

consumption 207, 208 

light 6, [71] 

requirements 206 

supply [100] 
power-on light [71] 
power-up byte 51 
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PR#1 130 
PR#2 143, 154 
PR#6 126 
PR#n 56. 70 
PRAS 217, 219, 220, 251 
PRBL2 118 
PRBYTE 118 

PREAD 72, 121, 134. 148. 177 
PRERR 118 
PRHEX 118 

primary character set 68, [73] 
printer 8 
PRINTER: 130 
processor status register 17 
ProDOS 126, 130, 143, 180, {39, 63] 
program counter (PC) 16,201 
prompt 58, 154 
characters 59 
PRTAX 118 

PSTATUS 72, 123. 134, 148 
PTRIG 166 

published entry points [32-36] 
pulfirom stack 17 
push onto stack 17 
PWRITE 72, 121, 134, 148 



Q command 145 
Q3 215, 217, 219 
question mark (?) 56, 59 
quit terminal mode 145 

R 

R commancl 132 
R/W 217, 219. 221, 257 
RA0-RA7 217 
RAM 17 

addressing 226-229 

locations [15J 
RAMRD 38, 39. 43, 44. 216, [46| 
RAMWRT 38, 39, 43, 44. 216. [46] 



random number 58 
random-access memory (RAM) 17 
RAS (row-address strobe) 228 
RD1B 257 
RD63 167 
RD80COL 105 
RDSOSTORE 105 
RDALTCHAR 105 
ROALTZP 26 
RDBNK2 26 
RDCHAR 62 
RDCRAM [46] 
RDDHIRES 106 
RDH1RES 45, 105 
RDIOUDIS 106, 165 
RDKEY 55. 57 
RDLCRAM 26 
RDMIXED 105 
RDPAGE2 105 
RDRAMRO 39 
RDRAMWRT 39 
RDTEXT 105 
RDTNO 167 
RDVBLMSK 166 
RDXYMSK 166 
RDYOEDGE 166 
read-only memory (ROM) 17 
READMOUSE 163, 168, [51-52] 
receive register 262 
registers 15, 213 
examining 190 
relative humidity 205 
REMIN 143 
remote 154, 159 
remote device 145 
REMOUT 143 
Crept j key [71] 
Request to Send See RTS 
(RESETJ key 4, 79. 82, 221. 113. 

[71] 
reset port 1 132 
reset port 2 145 
reset routine 48 
reset vector 49-51, [36] 

tRETUBH) [84] 
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retype 62 

RF modulator 233 

RGB monitor 245 

rollover 3 

ROM; 17 

ROM addressing 224-225 

R0MEN2 217 

RS-232 129 

RSTVBL 166 

RSTXINT 166, 216 

RSTXY 166 

RSTYINT 166, 216 

RTS instruction 260, |36J 



S command 132 
S register 17 

safety instructions 207, 199] 
schematic diagrams 27V276 
scratch-pad RAM [65! 
screen holes 36, 73. 74, 133. 134, 
136. 149, 171-173, [20-22. 47J 
SCRN 119 
scroll 65 
SEGA 218 
SEGB 218. 220. 251 
self-tests See diagnostics, built-in 
SER 221, 256 
serial buffering f55| 
serial data transfer [57J 
serial firmware [50] 
serial I/O buffers |75] 
serial VO port 128-159 
serial input buffer 37 
Serial Interface Card |74] 
serial interrupts [55, 56 j 
serial port circuits 254 
serial port 1 20, 129-139 



serial port 2 20, 141-159 

command cinaracter 143, 146 

command character hardware 
locations 130, 132, 134 

firmware protocol 147 

hardware locations 148 

initial characteristics 130, 147 
SEROUT 251 

SERVEf^OUSE 163, 168, [51] 
SETCOL 119 

SETt^OUSE 167-168J50-51] 
SETPWRC 51 
7M 220, 223 
(SHiFTj key 79, 229, [84] 
Shift-key mod 168] 
Sholes keyboard 5 
signature byte 134, 148. 170 
simplified keyboard (Dvorak) [88] 
© 126 
B5C02 12, 15. [63] 

address bus 213 

addressing modes 

block diagram 211 

clock 211 

cycle time [1, 2] 

data bus 213 

data sheet [5-13] 

differences from 6502 
[1-3, 6-7] 

execution time 

instruction set 

opcodes [12] 

registers 213 

signal descriptions 

timing diagram [8] 

timing signals 214-215 
6502 verus 65C02 211 
6551 Asynchronous Communication 
Interface Adapters See ACIA 
slot 7 drive 1 [74] 
SL0TC3R0M [66| 
SLOTCXROM [66] 
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[111 



J 

a 
3 



!j 



Ai.^ 



Index 



fci- 



i 

MB 



L 






slots 70 

versus ports [70] 
soft switches 22.215.218,221 

r«i 82 

SPACE (0) 132 
SPACE parity 138, [114] 
speaker 83-84, [67| 

external 7 

output jack 232 

volume control 232 
SPKR 219 
stack 24. [42, 46] 
stack pointer 17 
standard I/O links 55 
standard keyboard' 5 
start bit 137 

status register 134, 148, 261 
stop bits 137 
stop-list 65 
STORE command 194 
Strobe 79 

inputs 21 
SUD See System Utilities Disk 
Super Serial Cards [74] 
SWO 175 
SW1 175 

switch inputs 175, [76] 
switches, soft 22, 215 
SYNC 219, 233. 251 
system clock 213 
system monitor 179-203 
System Umies Disk 129, 131, 136, 
141. 145. ISO. [7S, 112] 

T 

T command 145. 154-156. 159 
QaE) [84] 
TD1B 257 
telephone jack 7 
temperature 205, 208 



terminal mode 145. [53] 

TEXT 105,107,218.220,221,251, 

[67] 
text 

and low-resolution graphics Page 1 
36 

and low-resolution Page IX 36 

and screen low-resolution Page 2 
37 

displays 241 

modes 90-95 

window 63, 66 
TLP1 36 
TLP1X 36, 45 
TLP2X 37 
toggle switches 22 
transferring control 42-43 
transferring data 41-42 
transmit/receive data register 134, 

148 
transmit register 262 
transparent mode 163,167,171 
triggering paddle timers [68] 
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USA standard keyboard 
USER command 197 
user's interrupt handler [57], 
utility strobe [67] 



validity check 49 
VBL [67, 73, 76] 
VBLINT 163, 164, 218, [67, 73] 
VDE [991 
vectors 55 
ventiiation 206 

VERIFY command 188, 196. |36] 
vertical blanking 163,(49,50,73] 
interrupts [68] 
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VID 248 
VID7M 215, 220 
video 

counters 233-234 

display 225 

display circuits 240 

display modes 239-247 

expansion 8 

expansion connector 249-252 

expansion output 249 

output signals 248 

routines 
firmare 115-123 
I/O firmware 120-123 
monitor 115-119 
VLINE 119 
tfoitage 205 

converter 10 
volume control 7, 232 

W 

WAIT [36] 

warm-start procedure 50 

Western Spanish keyboard [96] 

WNDW 219. 233. 251 

v^ford [106] 

Woz Integrated Machine 13. 222 



X register 17 

XO 215, 218,262, 264 

XI 215, 263, 264 
XFER 41, 42 
XirjT 164, [66. 67] 
XOEDGE 166 



Y register 17 
YO 218,262.264 
Y1 263, 264 
YfNT 164, [66, 67| 
YMOVE 219 
YOEDGE 166 



Z command 132, 139 
zap 132, 139, 145 
zero page 24, 184 
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